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PREFACE 


WHO SHOULD READ THIS MANUAL 


You should read this manual if you are developing a graphics 
application for the Professional 300 Series computer and need 
information about PRO/GIDIS, the General Image Display 
Instruction Set that runs on the Professional computer. 
PRO/GIDIS is one of the tools that can be used in developing 
graphics applications for the Professional computer. 


This document is intended for programmers who have had experience 


with systems programming and graphics applications software. The 
reader also is expected to be familiar with the Professional 300 
Series Tool Kit, and either MACRO-11 or FORTRAN. 


It is recommended that you also read the CORE Graphics’ Library 


(CGL) Manual for a more tutorial approach to graphics software 
development on the Professional computer. 


SCOPE OF MANUAL 


This manual describes PRO/GIDIS and is intended to be used as 
both a reference manual and user guide. It covers applications 
running on the Professional and also provides programming 
information about device-independent text and graphics 
programming with PRO/GIDIS. 


ORGANIZATION OF MANUAL 


The manual has ten chapters and three appendixes. The contents 
are summarized in the following subsections. 


Chapter 1 -- Introduction to PRO/GIDIS 


This chapter is the “user guide" for PRO/GIDIS. It provides an 
overview of PRO/GIDIS and its’ relationship to other graphics 
products, suggests when PRO/GIDIS should and should not be used, 
Summarizes the PRO/GIDIS instruction groups, and discusses each 
group in detail. 


Chapter 2 -- Interacting with the PRO/GIDIS Interpreter 
Describes the software interface to PRO/GIDIS. It describes’ the 
Queue I/O (QIO) directives that send instructions to PRO/GIDIS 


and return GIDIS reports, and provides PRO/GIDIS programming 
syntax rules and programming examples. 
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Chapter 3 -- Control Instructions 


Details the PRO/GIDIS instructions For program start-up, 
initialization, along with syntax-required instructions. 


Chapter 4 -- Viewing Transformation Instructions 


Describes the instructions used for mapping graphics addressable 
image areas to hardware output devices and the concepts involved 
in area transformation. 


Chapter 5 -- Global Attributes Instructions 

Details the global parameters that govern the appearance of 
drawing primitives (writing modes, line characteristics, pixel 
Size, area texture, and primary/secondary color). 

Chapter 6 -- Drawing Instructions 

Describes the instructions used for drawing lines and curves. 


Chapter 7 -- Filled Figures Instructions 


Details those PRO/GIDIS instructions that provide shading for 
closed figures. 


Chapter 8 -- Text Instructions 
Describes’ the instructions that control text subsystem 
characteristics (current alphabet, character selection for 


display, unit and display sizes, cell rotation and rendition, and 
so forth). 


Chapter 9 -- Area Operation Instructions 


Details those instructions that affect the display area and the 
instruction for dumping screen contents to the Professional's 
printing device. 


Chapter 10 -- Report Handling 


Describes report handling instructions that return state 
information from the output device. 


Appendix A -- Instruction Summary 
Lists the PRO/GIDIS instructions, their opcodes, argument list 


lengths, and associated parameters. Also features an instruction 
list sorted into opcode order. 
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Appendix B -- DEC Multinational Character Set 


Shows the code table for the Professional's alphabet 0, the DEC 
Multinational Character Set. 


Appendix C -- Alphabet Data Structure 

Appendix D -- Glossary 

RELATED DOCUMENTATION 

Please refer to the other manuals in the Tool Kit Documentation 


Set for more information on developing applications for the 
Professional. 
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1.4 


THE PRO/GIDIS INSTRUCTION SET 


Filled Figure Instructions 


These instructions draw solid figures by shading specific 
areas. 


Text Instructions 


These instructions control alphabets and draw graphics 
character text. 


Area Operation Instructions 


These instruction perform operations such as scrolling and 
printing on specific areas. 


Report Instructions 


These instructions cause PRO/GIDIS' to return specific 
information about the current state. 


CONTROL INSTRUCTIONS 


These are the instructions that control the operation of the 
PRO/GIDIS interpreter. 


INITIALIZE 


The INITIALIZE instruction restores power-on status to one or 


more graphics subsystems (addressing, global attributes, 
text, or all subsystems). 


NEW PICTURE 


The NEW PICTURE instruction clears the view surface to 
indicate the start of a new picture. 


END PICTURE 


The END PICTURE instruction indicates the end of a group of 
picture-drawing instructions. 


FLUSH BUFFERS 


The FLUSH BUFFERS instruction forces the execution of pending 
PRO/GIDIS instructions. 


CONTROL INSTRUCTIONS 


@ SET OUTPUT CURSOR 


The SET OUTPUT CURSOR instruction specifies the particular 
Character or object to be used as_ the output cursor (a 
Visible object used to mark the current screen output 
location). 


® SET OUTPUT CURSOR RENDITION 


The SET _OUTPUT_CURSOR_RENDITION instruction specifies whether 
the cursor blinks or is continuous. 


@® SET OUTPUT RUBBER BAND 
The SET OUTPUT RUBBER BAND instruction specifies if a rubber 


band is to be generated along with the cursor, and where the 
base of the rubber band is. 


@ NOP 
The NOP instruction performs no operation. and changes 
nothing. 


e@ END LIST 


The END LIST instruction indicates the end of a variable- 
length argument list. 


1.5 THE VIEWING TRANSFORMATION 


The graphical world is two-dimensional; we visualize it as a 
plane. The Cartesian coordinate system provides a convenient way 
of describing a plane. A coordinate pair specifies a discrete 
point in the form: 


py 
where X is the horizontal axis and Y is the vertical axis. 


The finite area of a plane that can be specified by coordinate 
pairs is called an address space. The origin of an address space 
is (0,0). Coordinate values increase in magnitude to the right 
and downward. 


THE VIEWING TRANSFORMATION 


PRO/GIDIS deals with three address spaces: 


GIDIS Output Space (GOS) 


GIDIS Output Space is the address space referenced by the 
GIDIS drawing instructions. 


Imposed Device Space (IDS) 
Imposed Device Space is the user-defined address space _ that 


provides a device-independent means of describing the view 
Surface. 


THE VIEWING TRANSFORMATION 


In effect, you change window parameters in order to "view" a 
different portion and/or scaling of Gidis Output Space. You 
change viewport parameters in order to "view" the same portion of 
GOS in a different portion of the view surface. 


Viewing transformation parameters only affect subsequently 
received GIDIS instructions. Changing the parameters does not 
affect images already visible on the view surface. In order to 


do that, you must change the mapping parameters and redraw the 
image. | 


1.5.7 Addressing Pixels 


Some applications, such as a natural image display, must address 
individual pixels directly. To accomplish this, set IDS space to 
width 1920 and height 1200. The picture aspect ratio is 8:5, a 
ratio that maps to the entire screen. Pixel X (from the left) on 
row Y is IDS coordinate [xX*2, Y*5]. 


There is a pixel at every X coordinate divisible by two and Y 
coordinate divisible by five. For example, [100,20], [22,15], 
and [78,505] all map directly to a pixel. PRO/GIDIS 
automatically truncates coordinates that map partway between 
pixels. For example, [101,23], [23,16], and [78,509] map to’ the 
same pixels as the first list of coordinates. 


NOTE 


An IDS of 960 by 240 does not accomplish the same 
thing. It would have a picture aspect ratio of 
4:1 (the unit aspect ratio is 1:1) which would 
not match the picture aspect ratio of HAS (8:5). 


1.6 DRAWING INSTRUCTIONS 


Part of the PRO/GIDIS state is a coordinate pair called the 
current position that corresponds to the current drawing location 
in GIDIS Output Space. The visual representation of the current 
position is the cursor. Thus, some of these instructions do not 
draw anything; they simply change the current position. 


DRAWING INSTRUCTIONS 


e SET POSITION 


The SET POSITION instruction specifies the new current 
position as an absolute location in GIDIS Output Space. 


@® SET_REL POSITION 


The SET REL POSITION instruction specifies the new current 
position as a point relative to (an offset from) the old 
current position. 


@ DRAW LINES 


The DRAW_LINES instruction draws one or more straight lines 
Starting at the current position. 


@ DRAW REL LINES 


Draws One or more straight lines starting at the current 
position. Coordinates specified are relative to the current 
position or the previous point. 


e DRAW ARCS 


Draws a section of a circle using the current position as a 
reference. 


e DRAW REL ARCS 


Draws a section of a circle using an offset from the current 
position as a reference. 


1.e/ FILLED FIGURE INSTRUCTIONS 


A filled-figure is a closed, shaded figure that can be bordered 
by either straight lines, circular arcs, or any combination of 
these. The instructions that begin and end filled figures are: 


e BEGIN FILLED FIGURE 


The BEGIN FILLED FIGURE instruction starts a filled figure 
definition. 


e END FILLED FIGURE 


The END FILLED FIGURE instruction ends ae filled FLgure 
definition and causes the entire figure to be filled in with 
the current area texture. 


THE WRITING MODE 


modes, we will call the “current pattern." The exact way in which 


PRO/GIDIS uses the current pattern to create images depends on 
the writing mode and the primary and secondary colors. 


Figure 1-8 shows the same line texture (which includes ON and OFF 


pixels) drawn over light and dark areas in all visible writing 
modes. 
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Figure 1-8: The Writing Modes Shown with Line Texture 
The writing modes are: 


® TRANSPARENT 


In transparent mode, no actual drawing is’ done. Otherwise, 
all other drawing processes are exercised and the state 


information (particularly, the current position) is updated. 
The texture is ignored. Transparent mode for determining the 
current position after drawing without actually drawing the 
image. 

® TRANSPARENT NEGATE 


This mode is identical to transparent mode. 


@ COMPLEMENT 


In complement mode, wherever the current pattern contains set 
(1) bits, PRO/GIDIS performs a bitwise inversion of the pixel 


1 oak Oe 


THE WRITING MODE 


value (color index). For example, a pixel containing 101 
(color map entry 5) changes to 010 (color map entry 2). 
Wherever the current pattern contains clear (0) bits, no 
modifications are made. 


The purpose of complement mode is to make images "Stand out" 
from whatever has already been drawn. If the appropriate 
color map entries contain complementary colors, the image in 
the display area is effectively reversed. The original image 
can be restored by repeating the process. 


Complement mode is likely to produce seams when filled 
figures overlap. Since filled figures include their borders, 
areas with a common border are considered to overlap. 


COMPLEMENT NEGATE 


Complement negate mode is identical to complement mode except 
that PRO/GIDIS negates the current pattern. Wherever the 
current pattern contains clear (0) bits, PRO/GIDIS performs a 
bitwise inversion of the pixel value (color index). Wherever 
the current pattern contains set (1) bits, no modifications 
are made. 


OVERLAY 


In overlay mode, wherever the current pattern contains’ set 
(1) bits, PRO/GIDIS draws in the current primary color. 
Wherever the current pattern contains clear (0) bits, no 
drawing occurs. 


The purpose of overlay mode is to draw images on top. of" 


whatever is already on the view surface. 
OVERLAY NEGATE 


Overlay negate mode is identical to overlay mode except that 
PRO/GIDIS negates the current pattern. Wherever the current 
pattern contains clear (0) bits, PRO/GIDIS draws in_ the 
current primary color. Wherever the current pattern contains 
set (1) bits, no drawing occurs. 


REPLACE 


In replace mode, wherever the current pattern contains set 
(1) bits, PRO/GIDIS draws in the primary color. Wherever the 
current pattern contains clear (0) bits, PRO/GIDIS draws in 
the secondary color. 


The purpose of replace mode is to draw images that completely 
replace whatever is already on the view surface. 
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FILLED FIGURE ATTRIBUTES 


I 


~BYTE 2epeds ; length 
«WORD 1000 653790 


ll 
NO 
ba] 


opcode SET POSITION 


BYTE O%4344 ; length = 0, opcode = BEGIN FILLED FIGURE 
»BYTE Si gc oe ; length = 3, opcode = DRAW_REL ARCS 

e WORD 6000.,3800.,180. 

~BYTE Saig23 % > length = 3, opcode = DRAW REL ARCS 

WORD 6000.,5532.,-60. a 

sBYTE Oegoce ; length = 0, opcode = END FILLED FIGURE 


Example 1-6: A Filled Figure Using DRAW_REL_ARCS 


sBYTE 2ag29% ; Jength = 2, opcode = SET POSITION 

«WORD 6904;3770%« 

BYTE Oey Ske ; length = 0, opcode = BEGIN FILLED FIGURE 
BYTE Swyeoe ; length = 8, opcode = DRAW _LINES 

» WORD T8906%3770 

«WORD 890.,17/70. 

«WORD 1890 4¢1770% 

» WORD 890.,3770% 

sBYTE Ow 732% ; length = 0, opcode = END FILLED FIGURE 


Example 1-7: A Filled Figure Using DRAW _LINES 


sBYTE 2s 29% ; length = 2, opcode = SET POSITION 

«WORD 3090353770 

sBYTE Oneug 3k >; length = 0, opcode = BEGIN FILLED FIGURE 
~BYTE 255% 5-258 ; END LIST terminated, opcode = DRAW_LINES 
« WORD 359:0..¢2270 % 

» WORD 4090.,3770. 

«WORD 2790.,2870. 

» WORD A290 65 26I0% 

«WORD 3090%5.37 10% 

-WORD -32768. 

~BYTE 0.,32. ; length = 0, opcode = END FILLED FIGURE 


Example 1-8: A Filled Figure Using DRAW_LINES 


1.13 TEXT ATTRIBUTES 


The following sections describe the PRO/GIDIS state variables 
that determine the appearance of text. 


1.13.1 Alphabets 


The SET ALPHABET instruction specifies the current alphabet, 
which is used when drawing characters, defining a new character, 
or erasing an existing alphabet in preparation for establishing a 
new alphabet. PRO/GIDIS supports up to 16 alphabets. 


IZ 
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Each alphabet is a list of characters. Alphabet 0 is the DEC 
Multinational Character Set (shown in Figure 1-11) and cannot be 
modified. Alphabets 1 through 15 can contain user-defined 
characters, which are represented as a two-dimensional raster 
(bit pattern) with a specific storage size (width and height). 
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Figure 1l-ll: Alphabet 0 


Characters within alphabets are referenced as a tuple (alphabet, 
character index). A character index is a value corresponding to 
the character's position in the alphabet. The first character 
has a character index of zero. Thus, an alphabet with 26 
characters would have index numbers in the range 0 to 25. 
Character indexes are unsigned, 16-bit integers. 


YOu can create a new alphabet of user-defined characters in two 
ways: 


1. Created Alphabets 


@ Use the SET ALPHABET instruction to specify the current 
alphabet. 


@ Use the CREATE ALPHABET instruction to clear any existing 
characters and to allocate storage for the new alphabet. 
No character definition can take place SH ok een | 
CREATE ALPHABET executes. 
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@® Use the LOAD CHARACTER CELL instruction to add characters 


to the alphabet. Or use BEGIN DEFINE CHARACTER and 
END DEFINE CHARACTER instructions. 


2. Loaded Alphabets 


@® Create a named region using P/OS facilities (see Tool Kit 


Manual, P/OS Directives). 
@ Use SET ALPHABET 


@ Use LOAD BY NAME 


For example (format described in Chapter 2): 


~BYTE Leip One ;length = 2, opcode = SET ALPHABET 


» WORD ie 

»BYTE 4.,46. ;length = 4, opcode = CREATE ALPHABET 
e WORD 8. ;width (storage pixels) 

«WORD LQ sheight (storage pixels) 

«WORD 96. -extent 

«WORD 0. ;width-type 


These instructions erase alphabet 1 and create a new alphabet of 
96 characters (numbered 0 through 95) with a storage size of 8 by 


10. The width-type parameter must be 0 for PRO/GIDIS on P/OS 
2603 


Figure 1-12: Character Cell Rotation 
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1.13.2 Cell Rendition 


The SET CELL RENDITION instruction specifies variations on 
characters that can be performed without selecting a new 
alphabet, yet are not related to writing colors or writing modes. 
The renditions defined for the Professional are backslant and 
italics. 


1.13.3 Cell Rotation 


The SET CELL ROTATION instruction specifies the angle at which 
characters are to be drawn, as shown in Figure 1-12. Actual 
rotation is the nearest possible angle to that requested. 
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Figure 1-13: Character Unit Cell and Display Cell 
1-28 
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1.13.4 Cell Oblique 


The SET CELL OBLIQUE instruction specifies the angle between the 
width and the height of the display cell for a non-rotated 
character. When the angle is non-zero, display cells are 
parallelograms, rather than rectangles. 


1.13.5 Cell Unit Size 


The SET CELL UNIT SIZE instruction specifies the actual size of 
the character pattern. Although you specify cell unit size in 
GIDIS Output Space coordinates, that size is only an 
approximation. PRO/GIDIS actually uses the largest integral 


multiple of the character pattern that is less than or equal to 
the specified size. 


1.13.6 Cell Display Size 


The SET CELL DISPLAY SIZE instruction specifies the size in GIDIS 


Output Space coordinates of the rectangle that contains the 
Character pattern. 


The unit cell and the display cell always are aligned at their 
upper left corners (see Figure 1-13). If the unit cell is larger 
than display cell, only a portion of the character is shown. Tf 
the unit cell is smaller than the display cell, PRO/GIDIS draws 
the unused portion of the display cell as if the pattern 
specified clear bits. 


1.13.7 Cell Movement 


Cell movement attributes specify how the current position changes 
after each character is drawn. The SET CELL MOVEMENT MODE and 
the SET CELL EXPLICIT MOVEMENT instructions specify these 
attributes. 


1.13.7.1 Movement mode - There are two ways to specify cell 
movement: implied and explicit, as shown in Figure 1-14. 


® Implied movement means that the current position moves a 
distance equal to the display cell width in the direction of 
the cell rotation. If the display cell width value is 
negative, the current position moves in the direction 
opposite to the cell rotation. 
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Figure 1-14: Character Cell Movement 
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@® Explicit movement means that the current position moves. as 
specified by your program in GIDIS Output Space coordinates. 
Explicit movement is not affected by the cell rotation. 


Implied movement can be disabled; explicit movement cannot. 
Thus, if implied movement is enabled, the cell movement is equal 
to the sum of the implied and explicit movements. 


PRO/GIDIS always draws characters in local symmetry. This means 
that characters with the same unit and display sizes always cover 
the same number of pixels. 


Cell movement can exhibit either local or global symmetry. when 
local symmetry is enabled (the default), all cell movements will 
be the same number of physical pixels. This means that all 


spaces will look the same on the screen but the "hard" position 
and the "soft" position can drift apart. Global symmetry keeps 
the "soft" position and the "hard" position together but allows 1 
pixel wide gaps between every few characters. (The "soft" 
position is calculated in GOS coordinates and the "hard" position 
in physical pixels.) 


1.14 AREA OPERATIONS INSTRUCTIONS 


These instructions perform operations on areas defined by the 
viewing transformation instructions. 


® ERASE CLIPPING REGION 


Changes entire output clipping region to current secondary 
color. 


@ PRINT SCREEN 


Prints a portion of the bitmap at the printer connected _ to 
the printer port. 


@ SCROLL CLIPPING REGION 


Moves the data within the output clipping region. 


1.15 REPORT HANDLING INSTRUCTIONS 


Report handling instructions return information about the current 
PRO/GIDIS state as well as success/failure reports for the 
immediately preceding PRO/GIDIS instructions. 


REPORT HANDLING INSTRUCTIONS 


The report path from the PRO/GIDIS interpreter to your program 
can be viewed as a data stream. It is possible to queue several 
pending reports. (P/OS 2.0 imposes a buffer limit of 18 words.) 


Your program sends a request instruction to the interpreter, 
which creates a report and puts it in the queue. Your program 
then reads the report queue (with a Read Special Data QIO system 
directive) in the order in which the requests are made. For an 
example of a report-reading routine, refer to Chapter 2. 


A report is a variable length block of words. The first word is 
a tag specifying the type of report and the number of words in 
the report. Your program must keep in synchronization with the 
report queue so that it is not reading a data word and 
interpreting it as a tag word. 


Your program also can set up an asynchronous system trap (AST) to 
be executed when a report is placed in the report queue. 


The following instructions request reports: 
@® REQUEST CURRENT POSITION 


PRO/GIDIS reports the X and Y coordinates of the current 
position. 


® REQUEST STATUS 


PRO/GIDIS returns a success or failure code for the last 
instruction executed. 


@® REQUEST CELL STANDARD 
PRO/GIDIS returns the standard character parameters (unit 
width, unit height, display cell width, and display cell 
height) for the current alphabet at the current’ rotation 
angle. 


@ REQUEST OUTPUT SIZE 


Reports the parameters of the size, shape and resolution of 
the video hardware used. 


@® REQUEST VERSION NUMBER 


Reports the version number of GIDIS. 


PRO/GIDIS INSTRUCTION SYNTAX 


In PASCAL, this could be: 


CONST 
INITIALIZE = 1; 
SET PRIMARY COLOR = 21; 


2e2e22 Parameter Blocks 


Most PRO/GIDIS instructions require a_ specific number Or 


parameters. For example, SET POSITION needs exactly two 
parameters. 


Some PRO/GIDIS instructions accept a variable number of 
parameters. The instructions in this category are DRAW LINES, 
DRAW_REL LINES, DRAW_ARCS, DRAW _REL ARCS, DRAW CHARACTERS, 
DRAW_PACKED_ CHARACTERS, and LOAD CHARACTER CELL. - 


A length value in the range 0 to 254 indicates a fixed-length 
parameter block. For example, if you specify a length value of 


two, PRO/GIDIS expects two parameter words as shown in example 
2-1 ® 


~-BYTE 2.,29. ;Instruction data block length = 2 
>Opcode for SET POSITION instruction = 29 

«WORD 100. >Horizontal coordinate for current pos. 

«WORD 350. ;Vertical coordinate for current pos. 
*>Following execution of this instruction, 
sthe current position is 100,550. 


Example 2-l: Instruction with Fixed-Length Parameter Block 


A length value of 255 indicates that the parameter block contains 
a variable number of parameter words terminated by an END LIST 
instruction word (-32768), as shown in example 2-2. Thus, in a 
variable-length parameter block, a parameter word cannot contain 
the value -32768. 


BYTE 255.,26.;END-LIST-term. ,opcode=DRAW REL LINES 


e WORD 10. -dxl 
e WORD -30. -dyl 
»WORD Z0:% °dx2 
«WORD +60. pdyZ 
e WORD -32768. ;END LIST instruction opcode word 


Example 2-2: Instruction with Variable-Length Parameter Block 
Either type of parameter block can be used with any instruction. 


This technique permits the PRO/GIDIS interpreter to handle 
erroneous or unsupported opcodes without aborting the program or 
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misinterpreting subsequent opcodes. If the interpreter does not 
recognize an instruction, that instruction and any data following 
are ignored. After counting and discarding the erroneous 
instruction's data, PRO/GIDIS proceeds to the next sequential 
instruction. 


NOTE 


PRO/GIDIS on P/OS V1.7 sets the status flag to 
SUCCESS when bg fails EO recognize an 
instruction. Version 2.0 and future versions set 
the status flag to FAILURE in this case and when 
not enough parameters are given. 


An instruction with insufficient parameters is not executed at 
all. An instruction with extra parameters is executed as though 
the extra arguments do not exist; the extra parameters are 
skipped and not interpreted as new instructions. For example, a 
SET POSITION instruction with only one argument is ignored, while 
a SET POSITION with three arguments uses the first two arguments 
and discards the third. 


2e3 SAMPLE MACRO-11 PROGRAM 


ITOSB: e BLKW 2 
OBUF: BYTE 0.,55. ;Length=0 REQUEST CURRENT POSITION 
RBUF': - BLKW 3. 
>SEND INSTRUCTION TO PRO/GIDIS 
QIOWSS #10.WSD,#5,#1,,#IOSB, ,<#OBUF,#2,,#SD.GDS> 


BCS ERROR ; DIRECTIVE FAILED 
TSTB TOSB 
BLE ERROR ;OPERATION FAILED 


*>READ THE REPORT 
QIOWSS #10.RSD,#5,#1,,#1IOSB, ,<#RBUF,#6, ,#SD.GDS> 


BCS ERROR *BRANCH IF DIRECTIVE FAILED 
Tolp TOSB 
BLE ERROR BRANCH IF OPERATION FAILED > 


> NEW CONTENTS OF RBUPF: 
- BYTE AT RBUF 2. (LENGTH) 

> BYTE AT RBUF+1 1. 

: (CURRENT POSITION REPORT TAG) 
* RBUF+2: CURRENT X POSITION 

> RBUF+4: CURRENT Y POSITION 


ERROR: *: EPror handling routine 


CHAPTER 3 


CONTROL INSTRUCTIONS 


This chapter contains a detailed description of each control 
instruction. Table 3-1 lists the instructions covered in the 
chapter. 


Table 3-l: Control Instructions Summary Chart 


1/1 INITIALIZE subsystem-mask-value 
6/0 NEW PICTURE 
24/0 END PICTURE 
28/0 FLUSH BUFFERS 
5/6 SET OUTPUT CURSOR alphabet, index, 
width, height, offset_x, offset _y 
72/1 SET OUTPUT CURSOR RENDITION mask 
53/3 SET OUTPUT RUBBER BAND type, base x, base y 
0/0 NOP 
128/0 END LIST 


3el1 INITIALIZE 
The initialize instruction restores PRO/GIDIS characteristics to 


their power-on default states. Specifically, this instruction 
sets up PRO/GIDIS device subsystem characteristics such as_ the 


31 


INITIALIZE 


color map, the primary color, secondary color, addressing, 
writing modes, and so forth. 


Opcode: 1 Lengths: 1 


Format: INITIALIZE subsystem-mask-value 
subsystem-mask-value iS a word that specifies a set of graphics 
subsystems as shown in Figure 3-l. 


Status: SUCCESS 


The INITIALIZE instruction represents device subsystems by 
specific bits in a mask value passed to PRO/GIDIS with the 
instruction. For example, a parameter value of 4 (bit 2. set) 
restores a device's text subsystem's power-on default conditions. 
The initialize instruction mask bit settings for the various 
subsystems are shown in Figure 3-l. 
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(Bits 8-15 are reserved) 


Figure 3-l: INITIALIZE Subsystem Initialization Bit Mask 


The PRO/GIDIS subsystems that can be selected for initialization 
are listed in Table 3-2. 


Table 3-2: Initialization Subsystems 
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Subsystem Description Bit 
Addressing - Resets the viewing transformation 0 

Global - Reinitializes writing mode, primary i 

Attributes color, secondary color, line and area 


texture, planes selected, and pixel size 
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Text - Resets the current alphabet, unit size, 2 


display size, cell rotation, cell 
rendition, implicit cell movement flag, 
and explicit cell movement 


Color map - Reinitializes the color map 4 
Alphabet - Clears all user-defined alphabets 5 
Cursor ~ Resets the output cursor and output 8 


rubber band 
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Notes: 

@® You can OR (logical inclusive) mask values together to 
initialize multiple subsystems in one instruction. 

@® A mask of -1 decimal (177777 octal) explicitly initializes 
all subsystems. 

@e The order of initialization is: (1) addressing, (2) global 
attributes, (3) text, (4) color map, (5) alphabet storage, 
and (6) cursor. 

@ Regardless of the mask word, the INITIALIZE instruction 
aborts any blocks begun with BEGIN FILLED FIGURE. 

@® Table 3-3 lists all of the state variables affected and their 
values after initialization. 

@® Some state variables are included in more than one subsystem. 

Example: 
~-BYTE Lay 2s >length=1,opcode for INITIALIZE 
«WORD Peet 235 tag >addressing, global attributes, 


sand text subsystems mask bits 


Table 3-3: Initialization Variable States 


output ids width default ids width (960) 
output ids height default ids height (600) 
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output 
output 
Output 
output 


gidis 
gidis 
gidis 
gidis 


output 
output 
output 
Output 


INITIALIZE 


viewport x origin 
viewport y origin 
viewport width 
viewport height 


output 
output 
output 
output 


Space x origin 
Space y origin 
Space width 
Space height 


clipping x origin 
clipping y origin 
clipping width 
clipping height 


current position x 
current position y 


line texture size 


area texture width 
area texture height 


logical pixel 
logical pixel 
logical pixel 
logical pixel 


cell 
cell 
cell 


cell 
cell 
cell 
cell 


movement 
explicit 
explicit 


width 
height 
x offset 
y offset 


mode flag 
movement dx 
movement dy 


display size width 
display size height 
unit size width 
unit size height 


0 
0 
default 
default 


0 
0 
default 
default 


0 
0 
default 
default 


0 
) 


ids 
ids 


ids 
ids 


ids 
ids 


width (960) 
height (600) 


width (960) 
height (600) 


width (960) 
height (600) 


line texture length * 


Standard unit 


width 


standard unit height 


O (1 hardware pixel) 


0 (1 hardware 


0 
0 


pixel) 


implied movement 


0 
0 


standard 
standard 
standard 
standard 


* converted to new GOS coordinates 


display width 
display height 
unit width 
unit height 


SET OUTPUT CURSOR 


Opcode: 5 Lengths 6 


Format: SET OUTPUT CURSOR alphabet, index, 


width, height, 
offset-x, offset-y 


alphabet specifies the alphabet containing the character or 


the special cursors indicator (-1l). 
index specifies the character or special cursor. 


width specifies the width of the cursor in GIDIS Output 
Space coordinates (greater than or equal to zero). 


height specifies the height of the cursor in GIDIS Output 
Space coordinates (greater than or equal to zero). 


offset-x specifies the X offset from the top left corner of 


the cursor to the current position (range 0 to 
width). 


offset-y specifies the Y offset from the top left corner of 


the cursor to the current position (range 0 to 
height). 


Status: SUCCESS if the requested character (alphabet, index) is 


defined, and width and height and coordinates are in 
range; otherwise FAILURE. 


Notes: 


The width and height (in PRO/GIDIS Output Space) are treated 
as a unit cell size; there is no equivalent of a display 
cell. When width and height are adjusted automatically to an 
integral multiple of the storage size of the character, the x 
and y offsets are adjusted by the same ratio. 


An alphabet code of -1l specifies that one of the _ special 
built-in cursors is to be used. For P/OS 2.0 these cursors 
are: 


No cursor 

Implementation default (same as 1) 
Tracking Cross (small cross) 

Crosshairs (full screen width and height) 
Block (solid rectangle) 


WN MH Or 


User-specified width and height are ignored when the tracking 
cross or crosshairs are used. All other values are reserved. 


SET OUTPUT CURSOR 


@® If the chosen cursor is not predefined (either a _e special 
cursor or a character in alphabet 0, your program must first 
define the character and then execute a SET OUTPUT CURSOR 
instruction. If the character is redefined after the 
SET OUTPUT CURSOR, the appearance of the cursor 1s unchanged 
until another SET OUTPUT CURSOR executes. 


@ SET OUTPUT CURSOR changes only the graphics mode cursor. 
However, turning on or off the VT102 emulator cursor has the 
side effect of turning on or off the graphics cursor. 


@ Once the SET OUTPUT CURSOR instruction executes, the 
appearance of the cursor changes immediately. 


Example: 


‘BYTE O47 0% ;length=6,opcode for SET OUTPUT CURSOR 

eWORD Lis Alphabet 1 (user-defined alphabet) 

«WORD Zs *eCharacter index value 
-(Assume that Alphabet 1, character-index 
72, is defined as an arrow pointing 
;straight upward 


e WORD 30. Width of 30 
«WORD 30. sHeight of 30 
«WORD imo *x offset 
«WORD O. 7y offset 


>The arrow is the new cursor with the tip 
> being at the current position. 


Example: 


«BYTE 6%: 756 ;length=6,opcode for SET OUTPUT CURSOR 


«WORD -l. *>PRO/GIDIS Cursor Alphabet 

«WORD aL >No cursor 

«WORD O. eWidth value of zero (ignored) 
eWORD O. sHeight value of zero’ (ignored) 
«WORD 3s >x offset (ignored) 

»WORD 4. >y offset (ignored) 


3-6 SET OUTPUT _CURSOR_RENDITION 


| The SET OUTPUT _CURSOR_RENDITION instruction determines if the 
cursor blinks or is continuous. 


SET OUTPUT CURSOR RENDITION 


Opcode: 72 Length: 1 
Format: SET OUTPUT CURSOR RENDITION mask 


mask is a word that specifies whether the cursor’ should 
blink or be continuous as shown in Figure 3-2. 
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Figure 3-2: SET OUTPUT CURSOR RENDITION mask 


Status: SUCCESS 
Example: 
»~BYTE 1.,/2. ;zlength=l, opcode for 


:SET_ OUTPUT CURSOR_RENDITION 
e WORD 0. sset to continuous mode 


3.7 SET _OUTPUT_RUBBER_BAND 
| The SET OUTPUT RUBBER BAND instruction specifies if a rubber band 
is to be generated along with the output cursor. It also gives 
the base of the rubber band. 
Opcode: 53 Lengths: 3 
Format: SET OUTPUT RUBBER BAND type, base _x, base_y 
type the type of rubber band to use. (see table 3-4) 


base x the x coordinate (in GOS) of the desired rubber band 
base 


base y the y coordinate (in GOS) of the desired rubber band 
base 


Status: SUCCESS if the type is legal; otherwise, FAILURE. 


Type Code Rubber Band 


SET OUTPUT RUBBER _BAND 


no rubber band 
default (same as -1l) 
rubber band line 
rubber band rectangle 


NO re © Fe 


Table 3-4: Types of Rubber Bands 


Notes: 


@® The rubber band (if selected) will be drawn each time the 
cursor 1S drawn. 


If the cursor blinks, then the rubber band also blinks. 


@e The rubber band line is drawn from the base position to the 
current position. 


@ The rubber band rectangle is the rectangle with one corner at 
the base position and the opposite corner at the current 
position. The rectangle will degenerate to a line or point 
if the current position and base position are the same in one 
or both coordinates. 


® Since both the cursor and the rubber band are drawn in 
complement mode, if they cover the same points, they will 
both disappear. It may be preferable to turn the cursor off 
when a rubber band is on. 


Example: 


~BYTE 34 OS >length=3., opcode for 
*SET OUTPUT RUBBER BAND 

eWORD ae rubber band line ~ 

«WORD 50'« e-the base is [50,60] 

e WORD 60. 


BYTE D2 2% ;length=1., opcode for set position 
e WORD 100. ;new current position 
e WORD 300. eis [100,300] 


swhen the cursor appears there 
ewill also be a rubber band line from 
°{[50,60] to [100,300]. 


NOP 


3.8 NOP 


The NOP instruction performs no operation. Execution of a NOP 
has no effect on the current state of PRO/GIDIS, other than to 
set the status flag to SUCCESS. 

Opcode: 0 Lengths: 0 

Formats: NOP 

Status: SUCCESS 


Notes: 


@ PRO/GIDIS ignores any arguments’ included with a NOP 
instruction. 


Example: 

~BYTE O03 ->length=0,opcode for NOP 
Example: 

~BYTE 26 40% ; length=2,opcode for NOP 


«WORD 1540. ;private data (ignored by PRO/GIDIS) 
«WORD Els ;private data (ignored by PRO/GIDIS) 


3.9 END LIST 


The END LIST instruction indicates the end of a variable argument 
list. This instruction follows the last argument in the list. 
Those PRO/GIDIS instructions often used with a variable-length 
argument list that terminates with an END LIST instruction 


include the following: DRAW LINES, DRAW REL LINES, 
DRAW_CHARACTERS, and LOAD CHARACTER CELL. 


Opcode: 128 Length: 0 
Format: END LIST 
Status: SUCCESS 

Notes: 


@® PRO/GIDIS ignores any arguments specified with an END LIST 
instruction. 


SET_OUTPUT IDS 


logical pixel x offset 0 

logical pixel y offset 0 

logical pixel width QO (1 hardware pixel) 
logical pixel height 0 (1 hardware pixel) 
cell movement mode flag implie1e,. Local 

cell explicit movement dx 

cell explicit movement dy 0 

cell display size width standard display width 
cell display size height standard display height 
cell unit size width standard unit width 
cell unit size height standard unit height 


* converted to new GOS coordinates 


4.2 SET OUTPUT VIEWPORT 


The SET OUTPUT _ VIEWPORT instruction specifies the viewport. 


Opcode: 


Format : 


13 Length: 4 


SET OUTPUT VIEWPORT ulx, uly, width, height 


The parameters are integer values representing IDS coordinates. 


ulx 


uly 


width 


height 


Status: 


Notes: 


specifies the x (horizontal) address of the origin of the 
viewport. 


specifies the y (vertical) address of the origin of the 
viewport. 


specifies the width of the viewport (value must be 
greater than zero). 


specifies the height of the viewport (value must _ be 
greater than zero). 


SUCCESS if width and height are greater than 0, FAILURE 
otherwise. 


@ No drawing is done by the SET_OUTPUT_VIEWPORT instruction. 


e If the picture aspect ratios of the window and viewport are 
not equal, only a portion of the viewport is used. 


SET OUTPUT VIEWPORT 


@ Unlike SET_OUTPUT_IDS and SET _GIDIS OUTPUT SPACE, this 
instruction does not change any of the state variables that 
depend on the definition of GIDIS Output Space (cell unit 
Size, line texture size, and so forth). The GOS values are 
preserved. This means that physical sizes will change when 
you change the viewport. 


Example: See SET GIDIS OUTPUT SPACE description. 


4.3 SET GIDIS OUTPUT SPACE 


The SET GIDIS OUTPUT SPACE instruction specifies the bounds of 
the window in GIDIS Output Space. It also sets the output 
clipping region to coincide with the window and resets all global 
attributes to their default values as shown in Table 4-3. 


Opcode: 9 Lengths: 4 
Format: SET GIDIS OUTPUT SPACE ulx, uly, width, height 


The parameters are integer values representing GIDIS Output Space 
coordinates. 


ulx specifies the x (horizontal) address of the origin of the 
window. 


uly specifies the y (vertical) address of the origin of the 
window. 


width specifies the width of the window (value must be greater 
than zero). 


height specifies the height of the window (value must be greater 
than zero). 


Status: SUCCESS if width and height are greater than zero, 
FAILURE otherwise 


Notes: 
@ No drawing is done when SET GIDIS OUTPUT SPACE executes. 
® It is recommended that a maximum absolute value of 16384 (2 
to the 14th power) be used for the following: ulx, uly, 


ulx + width, and uly + height. This will allow sufficient 
off-screen address space for accurate clipping. 


CHAPTER 6 


DRAWING INSTRUCTIONS 


This chapter contains a detailed description of each PRO/GIDIS 


drawing instruction. Table 6-1 lists the instructions covered in 
the chapter. 


Table 6-l: Drawing Instructions Summary Chart 
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29/2 SET POSITION X, VY 

30/2 SET REL POSITION dx, dy 

25/N DRAW LINES X, Vr eee 

26/N DRAW _REL LINES OX “OV4: ge 

23/N DRAW ARCS Xo: Vr. ANGIE). «2% 
27/N DRAW_REL ARCS dx, dy, angle, ... 


6.1 SET POSITION 


The SET POSITION instruction specifies a new current position as 
an absolute position in GIDIS Output Space. 


Opcode: 29 Length: 2 
Format: SET POSITION x, y 
x Specifies the new X (horizontal) value of the current 


position in GIDIS output space 
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SET POSITION 
y Specifies the new Y (vertical) value of the current 
position in GIDIS output space 
Status: SUCCESS 
Notes: 
@ No drawing is done when SET POSITION executes. 
Example: 


~BYTE 26g 20% ;Length=2, opcode for SET POSITION 
e WORD 100. ;New current position 
«WORD 350% ;is [100,350] 


6.2 SET_REL_POSITION 


The SET REL POSITION instruction specifies a new current position 
as an offset from the old current position in GIDIS Output Space. 


Opcode: 30 Lengths 2 
Format: SET REL POSITION dx, dy 


dx Specifies an offset from the current xX (horizontal) 
position in GIDIS output space 


dy Specifies an offset from the current Y (vertical) 
position in GIDIS output space 


Status: SUCCESS, provided no arithmetic overflow occurs; on 
overflow, FAILURE (position does not change) 


Notes: 
@ No drawing is done when SET POSITION executes. 


@ Global symmetry is preserved; SET REL POSITION [Dx,Dy] is 
always same as a ‘SET POSITION [Current_x + Dx,Current_y + 
Dy]'. 


Example: 


;Current position is [100,350] 
~BYTE 287 30% ;Length=2, opcode for SET REL POSITION 
«WORD 100. ;Relative position is 
«WORD -50. > [+100,-50] 

;New current position is [200,300] 


DRAW LINES 


6.3 DRAW _LINES 


The DRAW_LINES instruction draws a series of straight line 
segments, starting at the current drawing position. The end 


point of each line segment is specified as absolute coordinate 
pairs, expressed in GIDIS output space. 


Opcode: 25 Lengths n 
Format: DRAW LINES xl, yl, x2, y2, ..-. 


xl Specifies the X (horizontal) value of the first line's 
end point in GIDIS output space. 


yl Specifies the Y (vertical) value of the first line's’ end 
point in GIDIS output space. 


x2 Specifies the X (horizontal) value of the second line's 
end point in GIDIS output space. 


y2 Specifies the Y (vertical) value of the second line's end 
point in GIDIS output space. 


e+e Additional coordinate pairs specify end points EOr 
additional lines. 


Status: SUCCESS, provided no filled figure table overflow occurs; 
on overflow, FAILURE (position does not change) 


Notes: 


@e The coordinates can be specified either in a counted argument 
list (with the count supplied with the opcode word, or in an 
END LIST terminated list with 255 in the opcode word, as 
described in Chapter 2 of this manual. 


@e If there is an X coordinate with no Y coordinate, the lone X 
coordinate is ignored with no error indication. 


@ The DRAW LINES instruction is affected by the following 
global attributes: writing mode, primary color, plane mask, 
secondary color, pixel size, line texture, and filled figure 
flag. (See Note 4.) 


@® The way the coordinate parameters are used depends on the 
filled figure flag. When the filled figure flag yields 
FALSE, this instruction draws a straight line from the 
current position to the specified point. Then, the current 
position is changed and the specified point becomes the new 
current position. The next line is drawn from this new 
position to the location specified by the next parameter 
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DRAW LINES 


pair. 


® In complement and complement negate mode, common points (last 
pixel in one line, first pixel in the next) are drawn only 
once. The first pixel of a line is skipped and the last 
pixel is drawn. If the first pixel is the last pixel, the 
pixel is drawn. 


@ When the filled figure flag yields TRUE, this instruction 
Saves the given points in the filled figure table. No 
drawing is done; however, current position changes and is set 
to each specified (x, y) point. When the instruction 
completes, the current drawing position is located at the 
point indicated by the last parameter pair. When the filled 
figure table is full, coordinate pairs are ignored, and 
status is set to FAILURE. 


@ DRAW LINES modifies the bitmap only inside the clipping 
region. 


Example: 


*-Not in a filled figure definition 
-(filled figure flag is FALSE) 
Current position is [200,300] 
-BYTE DG 2 Oe *>Length=2, opcode for DRAW LINES 
-WORD 150% >Draw a line from [200,300] 
«WORD 200. 2to- [150,200 
s-New current position is [150,200] 


Example: 
current position is [150,200] 


enot in a filled figure definition 
<BY LS AD Oe ;Length=4, opcode for DRAW LINES 


«WORD 600. xl 
»WORD -10. oy i 
«WORD 300. x 2 
«WORD +10. 7y2 


Draw lines from [150,200] to [600,-10] 
then from [600,-10] to [300,10] 

>-New current position is [300,10] 

Note that both the -10 and the +10 are 
eabsolute coordinates. 


DRAW_REL LINES 


Examples: 


;Inside a filled-figure definition 
; (Filled figure flag is TRUE) 
Current position is [100,100] 

~-BYTE 5-,26. ;Length=5, opcode for DRAW REL LINES 


«WORD 100% Fe bak 
eWORD O. way 1 
«WORD Ow >dx2 
«WORD LOO. pdyzZ 
e WORD 79. 'ax3 


;Adds the points [200,100] and [200,200] 
;to the filled figure table 

;New current position is [200,200] 
7;Since there is no dy3, dx3 is ignored 


6.5 DRAW ARCS 


The DRAW_ARCS instruction draws a circular arc from the current 
position around the specified center. Direction of the arc is 
determined by the sign of the angle parameter. For example, a 
DRAW_ARCS 105,105,-90 instruction would draw a quarter-circle 
starting at the current position, using location 105,105 as_ the 
center of the arc’s circle. Because the angle's sign is 


negative, the arc drawn would be clockwise from the current 
position. 


Opcode: 23 Length: N 
Format: DRAW ARCS xl, yl, anglel, x2, y2, angle2 ... 


xl Specifies the X (horizontal) value of the first arc’s 
center point in GIDIS output space. 


yl Specifies the Y (vertical) value of the first arc's 
center point in GIDIS output space. 


anglel The angle for the first arc is given in degrees, with a 
positive value meaning counter-clockwise with respect to 
the physical screen. 


x2 Specifies the X (horizontal) value of the second arc's 
center point in GIDIS output space. 


y2 Specifies the Y (vertical) value of the second arc's 
center point in GIDIS output space. 


angle2 The angle for the second arc is given in degrees, with a 
positive value meaning counter-clockwise with respect to 
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the physical screen. 


«+» Additional coordinate and angle triplets specify center 
points and angles for additional arcs. 


Status: SUCCESS provided angle is within a range of -360 to +360 


and there is no filled figure table overflow, otherwise 
FAILURE. 


Notes: 


An angle of zero means no drawing is done; +/- 360 means a 


full circle. Values greater than 360 (or less than -360) are 
errors, and no arc is drawn. 


If the filled figure flag is TRUE then, instead of drawing 
the arc, all internally calculated interpolation points are 
added to the filled figure table. 


Fach arc starts at the end point of the previous arc. 
The current position is left at the end of the last arc. 


DRAW ARCS is affected by the following global attributes: 
writing mode, primary color, plane mask, secondary color, 
pixel size, line texture, and filled figure flag. 


In P/OS 2.0, the PRO/GIDIS interpreter calculates one 
interpolation point per 10 degrees of arc (or portion), 
regardless of the size of the circle. 


Full quadrant arcs always end at the exact point expected. 
Fractional quadrant arcs end at the closest available point, 
which might not be precisely correct. Multiple fractional 
quadrant arcs are not guaranteed to end at the exact point 
predicted by your program. For example, a full circle of a 
103 degree arc and a 257 degree arc is not guaranteed to 
leave the current position exactly where it started. 


DRAW ARCS modifies the bitmap only inside the clipping 
region. 


Examples: 


BYTE 
eWORD 
e WORD 
«WORD 


Example: 


BYTE 
e WORD 
e WORD 
«WORD 


Shy « 


400 @ 
300. 
TSO: 


32,23. 


400. 
300. 
-90 ® 


DRAW ARCS 


s;Not in a filled figure definition 
;(filled figure flag is FALSE) 
;Current position is [500,300] 
;Length=3, opcode for DRAW ARCS 

2x coordinate of center 

-y coordinate of center 

*180 degrees is one-half a circle 
; (counter-clockwise) 

7;Draws the top half of the circle 
centered at [400,300] with radius 100 
;Middle of the arc is [400,200] 
;New current position is [300,300] 


;Inside a filled-figure definition 
; (Filled figure flag is TRUE) 
;Current position is [500,300] 
;Length=3, opcode for DRAW ARCS 
Center is [400,300] 


7-90 degrees = 1] quadrant 

Adds nine interpolation points 
*(internally calculated) 

;to the filled figure table 

;Last point added is [400,400] 
;New current position is [400,400] 


6.6 DRAW REL ARCS 


The DRAW_REL ARCS instruction draws a circular arc 


from 


the 


Current position around the center, specified relative to the 
current position. Length of the arc is specified by an angle in 
degrees. Direction of the arc is determined by the sign of the 


angle parameter. 
Opcode: 27 Lengths: N 


Format: DRAW REL ARCS dx, dy, angle, dx, dy, angle, ... 


center point in GIDIS output space. 


dy Specifies the offset Y 
center point in GIDIS output space. 


dx Specifies the offset X (horizontal) value of the arc's 
(vertical) value of the arc’s 
degrees, with a positive value 


angle The angle is given in 
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meaning clockwise with respect to the physical screen. 


Status: SUCCESS, provided angle within a range of -360 to +360 


and there is no filled figure table overflow 
arithmetic overflow, otherwise FAILURE. 


Notes: 
Please. refer-to ‘the: notes bor DRAW ARCS. 
Example: 
Current position is [400,300] 


>Filled figure flag is FALSE 
~BYTE 3.,27. ;Length=3,opcode is DRAW REL ARCS 


«WORD ~100. Center is [-100,+30] 
»WORD +30. Relative to current position 
» WORD -90. 90 degrees = one quadrant (clockwise) 


*>Draws one quadrant from [400,300] to 
- [330,430] centered at [300,330] 
sNew current position is [330,430] 


Example: 
*Current position is [330,430] 


“Filled figure flag is FALSE 
~BYTE 6.,27. ;Length=3, opcode is DRAW REL ARCS 


e WORD +35. 7 

«WORD -50. :Center is [+35,-50] 

eWORD 90. ;{365,380], 90 degree arc 

e WORD -35. ;Current position is now [415,415] 
e WORD +50. ;:Center is 380,465] 

«WORD 90. -90 degrees 


draws a lens shaped object with two 
scircular arcs. 


Or 


END FILLED FIGURE 


The edges of the filled figure are the mathematically ideal 
lines through the positions in the filled-figure table, but 
one "extra" pixel is included to ensure that no gap occurs 
between two adjacent areas. The edge is not guaranteed to be 
identical to a line drawn (outside of a filled-figure 
definition) through the same points due to differences in 
drawing direction and round-off errors. 


The current position is unchanged by the END FILLED FIGURE. 
Current position is left at the last position given. Note 
that if table overflow occurred, the last point might not’ be 
the last vertex in the filled-figure table. 


This instruction modifies’ the bitmap inside the clipping 
region. 


If too many positions are specified, only the first 256 
vertices are used, and a straight line connects the 256th 
point with the first point. (256 is the maximum number of 
vertices in the filled-figure table for P/OS 2.0.) 


Global attributes used in the fill are: primary writing 
color, secondary writing color, writing mode, plane mask, 
area texture cell, area cell size, and area size. Unused 


global attributes are: pixel size. 


Complement and complement-negate writing modes can give 
unexpected results when filled figure areas overlap or abut. 


Example: 


~BYTE 
eWORD 
«WORD 
BYTE 


BYTE 
eWORD 
e WORD 
e WORD 
e WORD 


eBYTE 
e WORD 
e WORD 
e WORD 


eBYTE 


20429 % 


100. 
100. 


0.,31. 


4.,26. 


+100. 
+0. 
+0. 
+100. 


2D 064-209 % 


100. 
200. 


=32/108% 


0.,32. 


END FILLED FIGURE 


>Length=2,opcode for 
Current position 

> is [100,100] 
;Length=0,opcode for 
>Filled-figure table 
;Length=4,opcode for 
-dxl 

payi 

*CxZ 

;dy2 

;Adds points [200,100] and [200,200] to 
- the filled-figure table 


SET POSITION 


BEGIN FILLED FIGURE 
now has [100,100] 
DRAW REL LINES 


;END LIST terminated,opcode = DRAW LINES 
x1 

°x2 

7;END LIST 


sAdds point [100,200] to 

> the filled-figure table 
;Length=0,opcode for END FILLED FIGURE 

; The area defined by [100,100], 

1200; 10015. 1200, 200] .,- 1100,200),.:and 
[100,100] (a square) is filled with 
the current area texture (modified by 
whatever current global attributes are 
in effect.) 
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CHAPTER 8 


TEAT INSTRUCTIONS 


This chapter contains a detailed description of each text 

instruction. Table 8-1 lists the instructions covered in the 

chapter. 

Table 8-l: Text Instructions Summary Chart 

Opcode/Length Instruction/Arguments— 

38/1 SET ALPHABET alphabet-number 

46/4 CREATE ALPHABET width, height, extent, width-type 

34/n LOAD CHARACTER _CELL char-index, width, -d0O, dl,...,dn 

3374 BEGIN DEFINE CHARACTER char-index, width, nominal-width, 
nominal-height 

36/0 END DEFINE CHARACTER 

37/2 LOAD BY NAME name 0, name_l 

43/1 SET CELL RENDITION cell-rendition 

44/1 SET CELL ROTATION dx, dy 

65/1 SET CELL OBLIQUE axe: Ay 

45/2 SET CELL UNIT SIZE width, height 

40/2 SET CELL DISPLAY SIZE width, height 

42/1 SET CELL MOVEMENT MODE flag 

41/2 SET CELL EXPLICIT MOVEMENT dx, dy 
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TEXT INSTRUCTIONS 


35/n DRAW CHARACTERS char-indexl, char-index2, .. 


74/N DRAW PACKED CHARACTERS 2charindex, ... 


8.1 SET ALPHABET 


The SET ALPHABET instruction selects a specific alphabet to be 
used as the current alphabet. Any alphabet-related operations, 
except as noted, act on the currently selected alphabet. 


Opcode: 38 Lengths: 1 
Format: SET ALPHABET alphabet 


alphabet is an integer value in a range of QO to 15 that 
specifies the current alphabet. 


Status: SUCCESS if the alphabet number is valid (from 0 to 15), 
FAILURE otherwise. 


Notes: 


® Valid alphabet numbers for the Professional (P/OS 2.0) are 0 
through 15. Alphabet 0 is the DEC Multinational Character 
set. 


@® Alphabet 0, the DEC Multinational font, 1S a_ read-only 
alphabet and cannot’ be changed through PRO/GIDIS. Control 
characters (indices 0 through 31 and 127 through 160 decimal) 
are not included, and, if requested with DRAW CHARACTERS, 


appear as an error ("blob" or "checkerboard") character. 
Some indices are reserved and appear as a reversed question 
mark. 


@ The current alphabet can be reset to the power-on default (0) 
by the PRO/GIDIS INITIALIZE instruction'’s text subsystem 
option. 


@® No drawing is done by the SET ALPHABET instruction. 
Example: 


»BYTE jaree tone ;Length=1, opcode for SET ALPHABET 
«WORD 2» Selects alphabet #2 as current alphabet 


CREATE ALPHABET 


8.2 CREATE ALPHABET 


CREATE ALPHABET erases the current alphabet and reserves 


resources for an alphabet with the specified storage size (width 
by height by extent). 


Opcode: 46 Lengths: 4 or 5 


Formats: CREATE ALPHABET width, height, extent, width-type, 
initialize 


width is an integer in the range (0 to 16) that specifies 
the number of horizontal bits in a character pattern. 


height is an integer in the range (0 to 16) that specifies 
the number of vertical bits in a character pattern. 


extent is an unsigned integer that specifies the number of 
characters in the alphabet. Character indices can 
range from 0 to extent - l. 


width-type is reserved for future use. For the Professional, 
this value-must be 0. 


Initialize initializes all characters in the newly created 
alphabet. If O, initialize to blank. If it is not 
O, initialize to solid. Tf not present, then 
initialize to solid. 


Status: SUCCESS if width and height are greater than or equal to 
zero, the width type is zero, the current alphabet number 
is a valid user definable alphabet (not 0), and there are 
sufficient resources to create the alphabet; FAILURE 
otherwise. 


Notes: 


e Character indices are 16-bit numbers and do not necessarily 
correspond to DEC Multinational codes (except for alphabet 
0). 


@ For the Professional, all characters in an alphabet have the 
same storage size. 


® To reclaim alphabet space, CREATE ALPHABET 0,0,0,0 erases the 
existing alphabet and returns all of the alphabet's 
resources. 


CREATE ALPHABET 


® Since alphabet storage uses dynamic memory, use the 
REQUEST STATUS instruction to obtain the status of any 
CREATE ALPHABET instruction. 
Examples: 
;Current alphabet is alphabet number 2 
~BYTE 4.,46. ;Length=4, opcode for CREATE ALPHABET 
e WORD 10. swidth 
» WORD 16% sheight 
eWORD B2% extent 
«WORD 0. ;width-type (Note: MUST BE ZERO) 
;Erases alphabet 2 and 
; creates an empty alphabet with 
> the specified characteristics 
8.3 LOAD CHARACTER CELL 
The LOAD CHARACTER CELL instruction loads a character cell from 
the raster data given as parameters. This instruction acts on 
the currently selected alphabet. 
Opcode: 34 Length: variable 


Formats LOAD CHARACTER CELL char-index, width, dO, dl,...,dn 


char- index 


do, 


Status: 


width 


Gig cece 


The index of the character cell to be loaded. This | 
value must be ina range of 0 to extent - 1, where 
extent is the total character count for the alphabet. 


The width value must be in a range of 0 to the width 
value given with the CREATE ALPHABET instruction that 
established the alphabet. (P/OS 2.0 does not use 
this value. However, it still must be in the 
appropriate range.) 


Zero to 16 words of data to be loaded into the 
character cell. The top character cell row is loaded 
from the first data word (d0), the second row from 
the second data word (dl), and so forth. 


SUCCESS if character index is in a range of Q to 


extent - 1, and width is in a range of 0 to alphabet 
width; otherwise, FAILURE. 


LOAD CHARACTER CELL 


Notes: 


@ The leftmost pixel in a row comes from the low-order bit in 
the appropriate data word. 


® Characters cannot be loaded into any alphabet with an extent 
value of zero. 


® This command should not be used within a character definition 
block. (See the BEGIN DEFINE CHARACTER instruction.) 


Examples 


Alphabet 2 has width of 4, height of 5, 
> and extent of 10 
~BYTE Owego ays ;Length=6, opcode for LOAD CHARACTER CELL 


«WORD 9. ‘Character index (last cell in alphabet) 
e WORD 4. «Width 

«WORD ~B1011 sPatterns: ON ON OFF ON 

e WORD “~B1010 OFF ON OFF ON 

e WORD ~B1000 (Note the OFF OFF OFF ON 


»WORD ~“BOOO1 bit reversal) ON OFF OFF OFF 
OFF OFF OFF OFF 


Last row not given,cleared automatically 


~™e “BG BE BSH WE 


8.4 BEGIN DEFINE CHARACTER 


The BEGIN DEFINE CHARACTER instruction starts a character 
definition block in which all commands’) draw into the binary 
storage raster associated with the given character instead of 
drawing into the entire screen. This command is paired with the 
END DEFINE CHARACTER command. 


Opcode: 33 Lengths 4 


Format: BEGIN DEFINE CHARACTER char-index, width, nom_width, 


nom height — 
char-index The index of the character cell to be loaded. This 
value must be ina range of 0 to extent - 1, where 


extent is the total character count for the alphabet. 


width The width value must be in a range of 0 to the width 
value given with the CREATE ALPHABET instruction that 
established the alphabet. (P/OS 2.0 does not use 
this value. However, it still must be in the 
appropriate range.) 


nomwidth The nominal width specifies the desired width of the 
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BEGIN DEFINE CHARACTER 


character. 


nomheight The nominal height specifies the desired height of 


the character. 


Status: SUCCESS if current alphabet is not equal to 0 and 


Char_index is less than or equal to alphabet extend 
(current alphabet) and there are sufficient resources’ to 
define this character; otherwise FAILURE. 


Notes: 


Tf the character definition contains a circle, then that 
character will contain a circle when drawn with unit cell 
width and height proportional to the nominal width = and 
height. In other words, characters can be drawn with 
arbitrary scaling in X and Y. | 


This command implicitly saves the entire PRO/GIDIS. state. 
That state will be restored by the END DEFINE CHARACTER 
command. The following state will be imposed in place of the 
active state. 


output ids width Nominal Width 

output ids height Nominal Height 

Output viewport x origin 0 

output viewport y origin 0 

output viewport width Nominal Width 

output viewport height Nominal Height 

GIDIS output space x origin 0 

GIDIS output space y origin 0 

GIDIS output space width Nominal Width 

GIDIS output space height Nominal Height 

output clipping x origin 0 

output clipping y origin 0 

output clipping width Nominal Width 

output clipping height Nominal Height 

current position x 0 

current position y 0 

area texture width Nominal Width 

area texture height Nominal Height 

line texture size GOS Equiv. of ‘line 
texture length’ 

logical pixel x offset 0 

logical pixel y offset 0 

logical pixel width 1 hardware pixel 

logical pixel height 1 hardware pixel 

cell unit size width Nominal Width 

cell unit size height Nominal Height 

cell display size width Nominal Width 

cell display size height Nominal Height 
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BEGIN DEFINE CHARACTER 


cell movement mode flag implicit, local 
cell explicit movement dx 0 

cell explicit movement dy 0 

primary color 1 

secondary color 0 

Character cell all '0O's 

plane mask 1 

writing mode overlay 


@® BEGIN DEFINE CHARACTER commands can not be nested. 


@ Any INITIALIZE command will abort the character definition 
mode. 


@® The following commands are illegal inside a character 
definition block: 


BEGIN DEFINE CHARACTER 
LOAD CHARACTER_CELL 
CREATE ALPHABET 
LOAD BY NAME 


@ If BEGIN DEFINE CHARACTER fails, GIDIS may skip all further 
commands until an END DEFINE CHARACTER. In particular, 
REQUEST STATUS may not succeed, and your program may hang. 
So insure that all: BEGIN DEFINE CHARACTER commands be 
followed by an END DEFINE CHARACTER. 

@® Do not allow the VT102 simulator to do a full screen scroll 
while defining a character. See the END DEFINE CHARACTER 
example. 

Examples: 


See END DEFINE CHARACTER example. 


8.5 END DEFINE CHARACTER 

The END DEFINE CHARACTER instruction terminates the character 
definition block and makes that character available and restores 
previous conditions. 

Opcode: 36 Length: 0 

Format: END DEFINE CHARACTER 


Status: SUCCESS if character definition flag is TRUE; otherwise, 
FAILURE. 


Example: 


eBYTE 


BYTE 
e WORD 
e WORD 
«WORD 


-BYTE 
e WORD 


BYTE 
«WORD 
e WORD 
e WORD 
» WORD 
e WORD 
e WORD 
» WORD 
e WORD 
» WORD 


-BYTE 


100. 


-32768. 


END DEFINE CHARACTER 


0.,36. 


sassume current alphabet is l, 
size of alphabet 1 is 9 by 9. 
slength = 4, 

; Oopcode=BEGIN DEFINE CHARACTER 
sdefining character 3 

width 

snominal width 

snominal height 

snow ready to draw into the characters 
;storage area 

°IDS is 90 X 235. 

slength = 2, opcode=SET POSITION 
-[0,100] is moddle of left hand side. 


storage 


;end-list terminated, opcode=DRAW_LINES 
[40,200] 

; [80,100]. 

[40,01] 


> (07100) 
eend list 


7;END DEFINE CHARACTER 


Figure 8-1 illustrates some examples of the character 
defined in the example above. 


END DEFINE CHARACTER 


fy fs 
a. (> 
u 
\ ; 
| | 


Figure 8-1: End Define Character 


8.6 LOAD BY NAME 


The LOAD BY NAME instruction makes an alphabet that is defined in 
a named region available to users. The argument is a pair of 16 
bit words which contain a region name in RADS5O. Other software 
must explicitly create the region, either by the CRRGS directive 
or by defining the alphabet in a MACRO program and using’ the 
INSTALL command on the native tool kit. In either case the 
region must have the format shown in Appendix C. T£ no such 
alphabet (region) can be found then an alphabet containing no 
characters will be loaded. 


Opcode: 37 Lengths 2 

Format: LOAD BY NAME name_0, name_l 

name 0 , name_l are arguments that contain a region name in RAD 
50. 


Status: SUCCESS if the two word argument specifies a valid 
region, the region has the proper format, the current 
alphabet number is valid for a user definable alphabet 
(not 0) AND there are sufficient resources to load the 
alphabet, FAILURE otherwise. 


LOAD BY NAME 


Notes: 


@e Gidis does not create a region. The user should create a 
region and make sure it has the proper format. Use the RSX 
directive CRRGS and load it algorithmically or build a common 
library and install it using the INSTALL command on the 
native tool kit. In either case the region must have the 
Format shown in Appendix C. 


Examples: 

‘BY CE 2,37. ;length=2, opcode=LOAD BY NAME 

*-RAD50 "BOLD " ;let MACRO-11 compute the RAD5O for BOLD 
Examples: 

-BYTE Ley STS *>RAD50O for MYALPH 

«WORD 050500+001750+000001 7>MYA 

«WORD 045400+001200+000010 > LPH 


8.7 SET CELL RENDITION 


The SET CELL RENDITION instruction specifies the renditions to be . 
added to characters written following execution of this 
instruction. Renditions are variations on characters that could 
be performed without selecting a new alphabet, yet are not 
related to writing colors or writing modes. Renditions defined 
for the Professional are: backslant and italics. 


Opcodes: 43 Lengths 1 
Format: SET CELL RENDITION mask-value 


mask-value A mask representing one or more of the cell 
renditions. The mask value corresponds to one or 
more rendition bits set. (See Figure 8-2). 


Status: SUCCESS if the requested rendition is supported by the 
implementation, FAILURE otherwise. 


This instruction specifies a  bit-mask value indicating which 
renditions are to be added. Certain mask bits are reserved for 
future PRO/GIDIS enhancements. Figure 8-2 illustrates the 
defined rendition bits that can be selected. 


SET CELL RENDITION 


15 14 13 12 27) 10 & 8 7 6 5 4 3 2 2 0 
| estand Sealed eats Deecteel eeieis stecteais creciech ceeciee seach Siecle ee es 
Po a ep oe de a 
$——4--—$—-4+--4$--4—-4-— $= $f fe fp $f ft 


| -- Back Slant 
| -- Italics 
ret tT | tt td to ot t TUL UE une (Reserved) 


Figure 8-2: SET CELL RENDITION Bit Mask 


Notes: 


@e Setting both backslant and italics (mask value ~BO0011) is an 
error. In this case, rendition is undefined. 


@® Italics and backslant (reverse italics) are generated by 
oblique angles of -23 and +23 degrees, respectively. 
Requesting italic or backslant rendition overrides any 
specific oblique angle requested previously. Requesting an 


oblique angle after an italic rendition request nullifies the 
italic request. 


Example: 


~BYTE Dg peo ;Length=l1, opcode for SET CELL RENDITION 
»WORD 2% Requests italics rendition 


8.8 SET CELL ROTATION 


The SET CELL ROTATION instruction defines the angle of rotation 
at which the character is to be displayed. The character is 
rotated about the current position (upper left corner of the 
display cell) to the available rotation angle nearest to the 
angle specified. Table 8-2 shows the angles available. 


Opcode: 44 Length: l 
Format: SET CELL ROTATION angle 


angle The requested angle in degrees. A positive angle value 
indicates counter-clockwise from normal text. 


Status: SUCCESS 


SET CELL ROTATION 


Notes: 


@ No drawing takes place when the SET CELL ROTATION instruction 
executes. 


Example: 


~BYTE earn: oe ;Length=1, opcode for SET CELL ROTATION 


eWORD -90. ;Text to go down the screen 
Requested Actual 
0 0 
45 51 
90 90 
135 129 
180 180 
225 232 
270 270 
315 309 


Table 8-2: Cell Rotation Angles 
8.9 SET CELL OBLIQUE 


An obliqued character cell is slanted away from a true 
rectanglular orientation. The SET CELL OBLIQUE instruction 
specifies the angle from vertical of the side of the display 
cell. A positive angle parameter results ina back-slanted 
character; a negative angle yields a forward, italic-type slant. 
Oblique angles always are set for unrotated characters. The 
Oblique angle rotates with the specified rotation. 


Opcodes: 65 Lengths: 1 
Formats: SET CELL OBLIQUE angle 
angle The requested angle in degrees. A positive angle value 
indicates a backward slant; a negative angle indicates a 
forward slant. 
Status: SUCCESS 
Notes: 
@® No drawing takes place when SET CELL OBLIQUE executes. 
@® PRO/GIDIS (P/OS 2.0) uses an approximation algorithm to 
Oblique text which is accurate for small angles (less than 


ten degrees), less accurate for medium angles (up to 25 
degrees), and inaccurate for large angles. Increasing the 
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SET CELL OBLIQUE 


argument value will always increase the text oblique. 


Example: 


‘BY EE 1.,65. ;Length=1, opcode for SET CELL OBLIQUE 
» WORD =23% ;Regular italics (slanting right) 


8.10 SET CELL UNIT SIZE 


The SET CELL UNIT SIZE instruction specifies the actual size of 
character(s) displayed; the size is specified in GIDIS output 


space. The stored character pattern is mapped completely to’ the 
unit size. 


Opcodes: 45 Lengths 2 
Format: SET CELL UNIT SIZE width, height 


width A width value in GIDIS output space. The width must be 
greater than zero. 


height A height value in GIDIS output space. The height must be 
greater than zero. 


Status: SUCCESS if width and height are greater than zero, 
FAILURE otherwise 


For PRO/GIDIS, the unit size is restricted to an integral 
multiple of the character pattern (storage size). PRO/GIDIS uses 
the largest available size that is not larger than the _ size 
specified. If no available size is small enough, the smallest 
available is used. Refer to the SET CELL DISPLAY SIZE to define 
the size of the area in which the cell unit is displayed. 


Notes: 
@® The requested unit size does not change when the current 
alphabet changes, but the adjustment described above is 
recalculated. 


@ The unit cell and the display cell always are aligned at 
their upper-left corners. 


@® No drawing is done when the SET CELL UNIT SIZE executes. 
Examples: 
~BYTE 1.,45. ;Length=1, opcode for SET CELL UNIT SIZE 
«WORD 10. >Width : 
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8.11 


SET CELL UNIT SIZE 


«WORD 30. ;Height 


SET CELL DISPLAY SIZE 


SET CELL DISPLAY SIZE defines a character's display cell, the 
rectangular area of the display modified when a character is 
drawn. 


Opcodes 40 Lengths: 2 


Format: SET CELL DISPLAY SIZE width, height 


width A width value in GIDIS output space. 


height A height value in GIDIS output space. 


Status: SUCCESS 


Notes: 


The origin of the display cell is always the upper left 
corner of the cell and is aligned with the unit cell at that 
corner. 


The unit cell can be larger than the display cell; if so, the 
character is clipped to the display cell. If the unit cell 
is smaller than the display cell, then all of the character 
is drawn and the rest of the display cell is treated as if 
the character pattern specified OFF. 


Negative values in width or height produce a mirroring in xX 
and Y, respectively. This mirroring or reflection always is 
done about the origin (the upper-left corner of the cell). 
Implied movement always goes across’ the display cell, so 
implied movement for a display cell mirrored in X is in the 
opposite direction from the rotation angle. 


No drawing is done when the SET CELL DISPLAY SIZE executes. 


If either the width or the height is zero, no portion of a 
character is drawn. 


Examples: 


~BYTE 22,40. ;Length=2, opcode=SET CELL DISPLAY SIZE 
e WORD yar ;Width 
« WORD 28. ;Height 


SET CELL MOVEMENT MODE 


8.12 SET CELL MOVEMENT MODE 


The SET CELL MOVEMENT MODE instruction specifies the manner in 


which the current position moves after each character is drawn by 
a DRAW_CHARACTERS instruction. 


Opcode: 42 Length: 1 
Formats SET CELL MOVEMENT MODE flag 
flag specifies one of the following movement modes: 


Explicit cell movement, local symmetry 
Explicit cell movement, global symmetry 
Explicit and implied movement, local symmetry 
Explicit and implied movement, global symmetry 
(All other values are reserved.) 


W NOE © 


Status: SUCCESS if Flag is 0 to 3, FAILURE otherwise. 


Notes: 


@® When using local symmetry, the current position after a 
DRAW CHARACTERS instruction could be different from that 
calculated by your program. It is suggested that all such 
DRAW CHARACTERS instructions be followed with a SET POSITION 
instruction or a REQUEST POSITION instruction unless’ the 
exact end of the string is the desired position for the next 
instruction. 


@® When using global symmetry, the current position is exactly 
that value that would be calculated by your program. 
However, character spacing may not always be even due to 
round-off errors. 


@® No drawing occurs when the SET_CELL MOVEMENT MODE instruction 
executes. 


Example: 


«BYTE pee eae ;Length=1, opcode=SET CELL MOVEMENT MODE 
«WORD Ox ;Explicit local symmetry mode 


8.13 SET CELL EXPLICIT MOVEMENT 


The SET CELL EXPLICIT MOVEMENT instruction specifies the relative 
distance that the current position is to move after a character 


is drawn. The relative distance is specified in GIDIS output 
space. 


SET CELL EXPLICIT MOVEMENT 


Opcode: 41 Lengths: 2 
Format: SET CELL EXPLICIT MOVEMENT dx, dy 


dx Specifies the horizontal distance in GIDIS output space 
to move the current position. 


dy Specifies the vertical distance in GIDIS output space to 
move the current position. 


Status: SUCCESS 


The explicit value is the total movement when the cell movement 
mode is 0 or 1. The value represents the inter-character spacing 
when the mode is 2 Or 3% (Refer LO the preceding 
SET CELL MOVEMENT MODE description for detaids. on, amplied 
movement.) The default mode is 2, default explicit movement is 
[O40 )-% 


Notes: 


@® No drawing occurs when the SET CELL EXPLICIT MOVEMENT 
instruction executes. 


@® When using local symmetry, the current position after a 
DRAW CHARACTERS instruction could be different from that 
calculated by your program. It is suggested that all 
DRAW CHARACTERS instructions be followed with a SET POSITION 
instruction or a REQUEST POSITION instruction unless. the 
exact end of the string is the desired position for the next 
instruction. 


® The explicit movement is used exactly as specified. It is 
not adjusted according to the rotation angle. 


Example: 


BYTE 2.,41. ;Length=2,SET CELL EXPLICIT MOVEMENT 
«WORD E2s ° dx 
WORD om :dy 


8.14 DRAW CHARACTERS 


The DRAW CHARACTERS instruction displays each of the characters 
specified by each character index in the parameter list. The 
characters are taken from the currently selected alphabet. 


DRAW CHARACTERS 


Opcode: 35 Lengths: n 
Format: DRAW CHARACTERS char-index, ... 
char-index an unsigned 16-bit word 


Status: SUCCESS if the current alphabet number is valid and if 


the last character-index is valid in the alphabet, 
FAILURE otherwise. 


Characters can be specified either in a counted argument list 
(with the count supplied with the opcode word) or in an END LIST 
terminated list with 255 in the opcode word. The rules’ for 


variable-length argument lists for PRO/GIDIS are described in 
Chapter 2 of this manual. 


Notes: 


@® The current position is updated after each character display, 
according to the cell movement controls. (See the 
descriptions of the SET CELL MOVEMENT MODE and 
SET CELL EXPLICIT MOVEMENT instructions.) 


® This instruction uses implied and explicit cell movement, 


unit and display size, cell rotation, rendition mask, current 
alphabet, and writing mode. 


@ DRAW CHARACTERS modifies the bitmap (only inside the clipping 
region) and the current position. 


Examples: 


-Current alphabet = 0 (DEC Multinational) 
Unit size, display size, etc. are 
> set up properly 

BYTE 3.,35. ;Length=3, opcode for DRAW CHARACTERS 
;Counted form 


e WORD 65. 2 TAS 
«WORD 66. e 'B! 
«WORD 67. ee 


DRAW CHARACTERS 


Example: 


;Current alphabet = 1 (user-defined) 
;Unit size, display size, etc. are 
; set up properly 

~BYTE 253'%5 35% 7;END LIST Term.,opcode = DRAW CHARACTERS 


-WORD 0. 
.WORD 13. 
WORD 7. 
-WORD 45. 
-WORD -32768. ;END LIST 


;Displays 4 characters from alphabet 1, 
; which are user-defined characters 


8.15 DRAW PACKED CHARACTERS 


Opcodes: 74 Lengths: N 
Format: DRAW PACKED CHARACTERS 2charindex, ... 


2charindex is two 8 bit quantities which are used as character 
indexes to write. 


Status: SUCCESS if the current alphabet number is valid and if 
the last character-index is valid in the alphabet, 
FAILURE otherwise. 


Notes: 

@® The arguments are taken as pairs of characters. Fach word 
has 2 byte characters to draw. This command can be used for 
characters whose indexes are in the range 0-254. The value 
255 explicitly performs no operation. If you want to draw an 
odd number of characters, use 255 as the filler. See the 


DRAW CHARACTER command for a description of how characters 
are actually drawn. 


@® The low order byte is used first and then the high order 
byte. 


Examples: 


sassume current alphabet is 0 
~BYTE 32,74. *length=3 words,opcode for 
7 DRAW PACKED CHARACTERS 


BYTE L6G 6p O da 29°C 4. 65 
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| »~BYTE 
BYTE 


Examples 


BYTE 
eASCII 
-BYTE 
« WORD 
Example: 
~BYTE 
«WORD 
~BYTE 


BYTE 
BYTE 


DRAW PACKED CHARACTERS 


115.,116. 
49.,255. 


255.,/4. 
ve TEST" 


‘2y2o0% 
-32768. 


1.,38. 
1. 


2-,/4. 


Dis. ple 
255., 254. 


se es 


ae re 
e's 
: yt no character 


current alphabet 0 
-end-list-term, opcode=1l 
; DRAW_PACKED CHARACTERS 
stest 

2'2', no character 


slength=1, opcode=set-alphabet 
salphabet 1 


>length=2, 

+ Opcode=DRAW_PACKED CHARACTERS 
sdraw characters 0,1 

; and 254 from alphabet 1. 


PRINT SCREEN 


corresponds to the upper left vertical coordinate (y) of 
the data to be printed. The value is given in GOS 


coordinates. 
Status: SUCCESS 


Notes: 


® Ina single plane system, a pixel value of 0 is mapped to a 
Skip (leaves paper white) and a 1 is mapped to a strike 
(prints on the paper). On multi-plane systems, the 
monochrome value of the color map is tested. If 0, the point 
is skipped (white), if not zero, the point prints. 


® If the printer port does not have an LA5O or LA1O0O connected, 
nothing occurs. 


Examples: 


~BYTE 6.,141. ;Length=6, opcode for PRINT SCREEN 


«WORD 100. ;Upper left bitmap corner 

«WORD 100. ; is [100,100] 

e WORD 400. Data to be printed is 400 units wide 
e WORD 200. ; by 200 units high 

«WORD 0. ;Begin printing at current printhead 
«WORD O. ; location 


9.3 SCROLL CLIPPING REGION 


The SCROLL CLIPPING REGION instruction moves data within the 
output clipping region, according to the direction and distance 
specified by the instruction'’s accompanying parameters. The 
vacated display area is reset to the current secondary color, 
ignoring area texture and writing mode. 


Opcode: 52 Lengths 2 
Format: SCROLL CLIPPING REGION dx, dy 


dx The GIDIS output space distance to move the data 
horizontally. If dx is positive, the data is shifted 
right to left; if negative, the shift is to the right. 


dy The GIDIS output space distance to move _ the data 
vertically. If dy is positive, the data is shifted 
toward the top of the screen; if negative, the shift is 
toward the bottom of the screen. 


SCROLL CLIPPING REGION 


Notes: 


PRO GIDIS will copy the data in the currently selected planes 
directly to the desired position. Planes not selected are 
not scrolled or otherwise changed. Hardware assist is used 
when possible so the appearance of the screen may be 
different during the scroll operations. Scrolls that include 
everything on the screen, except the 32 pixel wide bands on 
either side, might scroll those bands in addition to the 
clipping region. (See Figure 1-5 for a picture of the screen 
showing the 32 pixel wide bands). 


® The data scrolled out is not saved -- you cannot scroll out a 
portion of an image and then scroll it back in. Solid 
secondary color always scrolls in. 

@® Shaded areas within the clipping region will not necessarily 
be aligned with shaded areas outside the clipping region 
after this command. 

@® Scroll Clipping region does not work in P/OS 1.7 except when 
the clipping region is set to the entire screen, and the 
plane mask includes all planes present. It works correctly 
in P/oS 2.0 for all combinations of plane mask and clipping 
region. 

Example: 

-BYTE 22,52. ;Length=0, opcode=SCROLL CLIPPING REGION 

-WORD 0. ;dy | 

-Slides data to the right 100 units 

Example: 

.BYTE 2.,52. 

» WORD QO. ;Scroll data down 
Examples: 


eBYTE Zagoe 
e WORD -30 eMove data in the clipping region 
» WORD +30 -30 units left and 20 units up. 


CHAPTER 10 


REPORT HANDLING 


This chapter contains a detailed description of each of the 
report handling instructions. Table 10-1 lists the instructions 
and report tags covered in the chapter. 


Table 10-1: Report Handling Summary Chart 


Em Gm ENED coup Se miteD TEED eam aD ED RED WEED ED em PEED sD SOE wen GED aD ee “EP eam <om 


55/0 REQUEST CURRENT POSITION CURRENT POSITION REPORT x, y 


58/0 REQUEST STATUS STATUS REPORT code 

54/0 REQUEST CELL STANDARD CELL STANDARD REPORT uw, uh, dw, 
dh 

71/0 REQUEST VERSION NUMBER VERSION NUMBER REPORT dev_code, 


version number 


57/0 REQUEST OUTPUT SIZE OUTPUT SIZE: REPORT ulx, uly, 

screen width, 
screen height, 
total width, 
total height, 
resolution x, 
resolution jy, 
total plane mask 


10.1 REQUEST CURRENT POSITION 


The REQUEST CURRENT POSITION instruction reports the absolute 


10> 1 


REQUEST CURRENT POSITION 


location of the current position. The current position is the 
display location at which the next character, line, or arc would 
be drawn. 


Opcode: 55 Lengths: 0 

Format: REQUEST CURRENT POSITION 

Status: SUCCESS 

The reported information takes the following form: 
CURRENT POSITION REPORT, xX, y 


The X and Y values reported are the PRO/GIDIS output space 
coordinates of the current position. 


Notes: 


® The current position is not necessarily the same as the last 
position given to SET POSITION or DRAW LINES; DRAW CHARACTERS 
and DRAW ARCS instructions also move the current position. 


@® The REQUEST CURRENT POSITION instruction is most useful 
following a DRAW ARCS or a DRAW CHARACTERS (local symmetry), 
Since your program cannot determine precisely where PRO/GIDIS 


leaves the current position after these instructions. 


Examples: 


-BYTE 0.,55. ;Lgth=0, opcode=REQUEST CURRENT POSITION 


This instruction causes the following 
report to be placed in the report 
queue if there is sufficient room. 


BO WH WHE WS %% @ 


Byte 2. (Data words following) 
Byte 1. (Current Pos. Rpt. Tag) 
Word x (PRO/GIDIS coordinates 
Word y for current position) 


~wG BE BWE 


=e 


The report can be read using a QIO 
with the function code IO.RSD. Refer 
to Chapter 2 for more information. 


a) oe fe WES 


10.2 REQUEST STATUS 


REQUEST STATUS reports the success or failure of a PRO/GIDIS 
instruction. All PRO/GIDIS instructions set the status variable. 


LO=2 


REQUEST STATUS 


Opcode: 58 Lengths 0 

Format: REQUEST STATUS 

Status: SUCCESS 

Status is reported in the following format: 
STATUS REPORT, status 


where the low-order bit of the variable status is either 1 
indicating SUCCESS or 0 indicating FAILURE. 


Notes: 


@ No other codes are defined. (Codes other than 0 or 1 are 
reserved for future use.) 


@ FAILURE status 1S not_ saved. If your program needs 
information about the success or failure of every 


instruction, you must place a REQUEST STATUS instruction 
after each PRO/GIDIS instruction. 


® Testing is recommended only following major PRO/GIDIS 
instructions, such as CREATE ALPHABET. 


Example: 


;assumes previous instruction failed 
«BYTE O p56 8 ;Lgth=0, opcode=REQUEST STATUS 


Byte 1. (Data words following) 
Byte 4. (Current Stat. Rpt. Tag) 
Word 0 (FAILURE status) 

>For additional examples, refer to 
Chapter 2. 


wG Bw BAGH BW 


10.3. REQUEST CELL STANDARD 


The REQUEST CELL STANDARD instruction reports the current unit 
cell and display cell sizes. 


Opcode: 54 Lengths: 0 
Format: REQUEST CELL STANDARD 
Status: SUCCESS 


The report takes the following form: 


10-3 


REQUEST CELL STANDARD 


CELL STANDARD REPORT, unit-wd, unit-ht, 
display-wd, display-ht 


where unit-wd and unit-ht are the unit cell width and height 


of 


the standard size character in GIDIS space. Display-wd and 


display-ht are the display cell width and height. 
Notes: 


e This instruction takes into account the storage size of 


the 


current alphabet and the character rotation currently in 
effect. The standard size for alphabet 0 (DEC Multinational) 
is not necessarily the same as the standard size for alphabet 


es 


@ Rounding could take place converting from device coordinates 
to GIDIS space. If your program requests ‘n' times the size 


of the standard, the characters actually formed might not 
precisely ‘n' times the standard. 


Examples: 


-BYTE 0.,54. ;Lgth=0, opcode=REQUEST CELL STANDARD 
Byte 4. (Data words following) 
Byte 5. (Cell Standard Rpt. Tag) 
Word 9. (Unit width) 

Word 20. (Unit height) 

Word 8. (Display width) 

Word 20. (Display height) 


=e =~“ WE WH WE WH WS 


>For additional examples, refer to 
Chapter 2. 


10.4 REQUEST OUTPUT SIZE 


The REQUEST OUTPUT SIZE command reports the parameter of 
device currently used. 


Opcode: 57 Length: 0 


Formats REQUEST OUTPUT SIZE 


Status: SUCCESS 


10-4 


be 


the 


Examples: 


OUTPUT SIZE REPORT, 


REQUEST OUTPUT SIZE 


The report takes the following form: 


ulx, Diy; screen width, 
screen height, total width, total height, 
resolution x, resolution y, Total plane mask 


where 


® [ulx, uly] is the upper left corner (in Output IDS) 
of the total device executable space; 
® Screen width and Screen height are the width and 


height (in 


Output IDS) of the visible area of the 


output device; 
® Total width and Total height are the width and height 
(in Output IDS) of the total device executable space; 


® Resolution x 
addressable 


and Resolution y are the number of 
units (pixels) in the total device 


executable space; 
® Total plane mask is the plane mask that contains a 1 
for every plane accessible. 


Assume IDS is 960 by 600 


~BYTE Oay DT ;length=0,opcode for REQUEST OUTPUT SIZE 
e WORD ‘Os stotal upper left is [-32,0] 

»WORD 1024 IDS width and height of visible area 

e WORD 600 ° 

eWORD 1024 IDS width and height of total area 
»WORD 600 ; 

«WORD 1024 snumber of pixels in total device width 
e WORD 240 snumber of pixels in total device height 
«WORD Te stotal plane mask 

-BYTE 9. 9 words following output size report tag 
sBYTE 2% ;OUTPUT_ SIZE REPORT TAG 

» WORD -32. *IDS coordinate of 

‘BYTE oO edata words following 


10.5 REQUEST VERSION NUMBER 


| The REQUEST VERSION NUMBER instruction reports the version number 
of PRO/GIDIS. 


10=5 


REQUEST VERSION NUMBER 


Opcode: 71 Lengths: 0 


Format: REQUEST VERSION NUMBER 


status: SUCCESS 


The reported information takes the following form: 
VERSION NUMBER REPORT, device code, version 


where 


@ device code is 21 for the PRO/VIDEO GIDIS. 
® version is the version number. 


Notes: 


® These numbers should be used with all error reports. 


Examples: 


BYTE Oop be sLgth=0, opcode=VERSION NUMBER REPORT 
sbyte 2. data words following 
7; VERSION NUMBER REPORT 
sbyte 7. tag 
eword 21. device code 
eword 25. version number 


LO0=6 


APPENDIX A 


PRO/GIDIS INSTRUCTION SUMMARIES 


This chapter contains a PRO/GIDIS instruction 


different orders: 
alphabetic order. 


by function, 


summary 


in ascending opcode order, 
The opcode and parameter block 


length 


three 
and in 
values 


in 


are shown as a word value as well as separate byte values. 


INSTRUCTIONS GROUPED BY FUNCTION 


A.l 
Opcode 
Length 
Opeode Word 
0 O QO 
EF 2 -25:7 
5 6 1286 
6 O 1536 
24 Q 6144 
28 Q 7168 
53. 3 13571 
72 1 18433 
128 QO -32768 
4 4 1028 
9 4 2308 
12 2 3074 
13’ 4 3332 
3. w2- “770 
14 2 3586 
15 1 3841 
16 6 4102 
Ll? 3 4355 
19 4 4868 
20 Jt. Db12) 
2) 1 S377 


NOP - 

INITIALIZE mask 

SET OUTPUT CURSOR a, 
NEW PICTURE - 

END PICTURE - 
FLUSH BUFFERS - 
SET OUTPUT RUBBER_BAND ty 


Cy 


SET | OUTPUT _ ~ CURSOR _ RENDITION mask 


END _ Lisl. = 


SET OUTPUT CLIPPING REGION x, 


SET GIDIS OUTPUT SPACE x, 
SET OUTPUT IDS w, h 
SET OUTPUT VIEWPORT x, y, 
SET AREA_TEXTURE_SIZE w, 
SET AREA TEXTURE a, c 
SET SECONDARY COLOR color 
SET COLOR MAP ENTRY m, 


Wy 


De, 


Yr 
Wy 


h 


COLOF,; 


hy 


x 


OX » 


a 


Yr 


Wy 


h 


ry 


ag 


h 


SET LINE TEXTURE length, pattern, 


SET PIXEL SIZE w, h, 
SET PLANE MASK mask 
SET PRIMARY COLOR color 


Ox, 


A-1 


OY 


Gy 


Oy 


w, h 


Db, 
size 


control 
control 
control 
control 
control 
control 
control 
control 
control 


transform 
transform 
transform 
transform 


attributes 
attributes 
attributes 
mono rt 

attributes 
attributes 
attributes 
attributes 


INSTRUCTIONS GROUPED BY FUNCTION 


SET WRITING MODE mode 
SET AREA CELL SIZE w, h 


DRAW ARCS X, y, 

DRAW LINES x, y, 
DRAW _ REL LINES ax, dy, 
DRAW_ REL ARCS dx, dy, 

SET POSITION X, VY 

SET REL POSITION dx, dy 


angle 


angle 


BEGIN FILLED FIGURE - 
END FILLED FIGURE - 


nh 
d15 


BEGIN DEFINE CHARACTER c, 
LOAD | CHARACTER _ CELL: -Cy. Ww; 
DRAW CHARACTERS Cy 
END DEFINE CHARACTER - 

LOAD _ BY... NAME name 0, name 1 
SET ALPHABET a 

SET CELL DISPLAY SIZE w, h 

og a CELL _ EXPLICIT _ MOVEMENT dx, 
SET_ CELL. MOVEMENT _ MODE flag 
oT. UCB bi... RENDITION flags 

SET CELL ROTATION angle 

SET CELL UNIT SIZE w, h 

CREATE ALPHABET w, h, extent, 
SET CELL OBLIQUE angle 

DRAW PACKED CHARACTERS 2charindex, .. 


Wr 
do, 


nw, 


@® ® ® 


dy 


type 


ERASE CLIPPING REGION - 
SCROLL CLIPPING REGION dx, dy 
PRINT SCREEN x, y, w, h, hx, hy 
REQUEST CELL STANDARD - 
REQUEST CURRENT POSITION - 
REQUEST OUTPUT SIZE 

REQUEST STATUS - 

REQUEST VERSION NUMBER 


INSTRUCTIONS IN OPCODE ORDER 


attributes 
attributes 


drawing 
drawing 
drawing 
drawing 
drawing 
drawing 


filled figures 
filled figures 


text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 
text 


area 


area 
area 


(RAD50) 


reports 
reports 
reports 
reports 
reports 


22 1 5633 
69 2 17666 
23 3. 5691: 
25 N 6400+N 
26 N 6656+N 
27 3 6915 
29 2 7426 
30 2 7682 
31 Q 7936 
32 0 £8192 
33 2 8450 
34 N 8704+N 
35 N 8960+N 
36 OO 9216 
37 2 9474 
38 1 9729 
40 2 10242 
41 2 10498 
42 1 10753 
43 1 11009 
44 1 11265 
45 2 11522 
46 4 11780 
65 1 16641 
74 N 18944+4N 
48 0 12288 
52 2 13314 
141 6 -29434 
54 QO 13824 
55 QO 14080 
57 O 14592 
58 QO 14848 
71 QO 18176 
A.2 
Opcode 
Length 
Opcode Word 
0 dO QO 
L.. «dt 257 
3. j2° “F410 


NOP - 
INITIALIZE mask 
SET AREA TEXTURE SIZE w, h 


A-2 


control 
attributes 


NODZHONKFOCODOWNORBNKFHENNFNOAZARPOONNOWAYA BZOWHMRPRBWOHARNSENLODS 


8452 


8704+N 
8960+N 


9216 

9474 

9729 

10242 
10498 
LOF53 
11009 
11265 
LL 22 
11780 
12288 
13314 
135 74 
13824 
14080 
14592 
14848 
16641 
17666 
18176 
18433 


18944+N 
-32768 
-29434 


INSTRUCTIONS IN OPCODE ORDER 


SET _OUTPUT_CLIPPING REGION x, y, 
SET OUTPUT CURSOR a, c, w, h, 
NEW PICTURE - 

SET GIDIS OUTPUT SPACE x, y, WwW, 
SET OUTPUT IDS w, h 

SET OUTPUT VIEWPORT x, y, w, h 
SET AREA TEXTURE a, c 

SET SECONDARY COLOR color 

SET COLOR MAP ENTRY m, color, r, 


SET_ PIXEL SIZE w, h, 
SET PLANE MASK mask 
SET PRIMARY COLOR color 
oy on ae WRITING _ MODE mode 
DRAW ARCS X, Y, angle 
END PICTURE - 
DRAW_LINES xX, Yy eee 
DRAW REL LINES dx, dy, 
DRAW REL ARCS dx, dy, 
FLUSH BUFFER - 

SET POSITION X, VY 

SET _REL POSITION dx, dy 
BEGIN FILLED FIGURE - 

END FILLED FIGURE - 

BEGIN DEFINE CHARACTER Cc, w, 
LOAD CHARACTER_CELL c, w, dO, 
DRAW CHARACTERS c, «ee 

END DEFINE CHARACTER - 

LOAD BY NAME name_0, name_1 
SET ALPHABET a 

SET CELL DISPLAY SIZE w, h 


OX, OY 


angle 


nw, 


SET 2 PICELIs | _EXPLICIT_ MOVEMENT dx, dy 


SET [CREEL MOVEMENT _ MODE flag 
SET_ CELE. RENDITION flags 

SET_ CELL. ROTATION angle 

OBI: Melanie _UNIT_ SIZE w, h 
CREATE ALPHABET w, h, extent, 
ERASE CLIPPING REGION - 
SCROLL CLIPPING REGION dx, dy 
SET OUTPUT RUBBER BAND type, x, 
REQUEST CELL STANDARD - 

REQUEST CURRENT POSITION - 
REQUEST OUTPUT SIZE 

REQUEST _ STATUS - 

SET _ CELL _OBLIQUE angle 

SET AREA _ CELL SIZE w, h 

REQUEST _ VERSION _NUMBER - 

SET OUTPUT _ CURSOR_ RENDITION mask 


Wr 
OX, 


Gr 
SET_ LINE _ TEXTURE length, pattern, size 


OY 


nh 
d15 


type 


DRAW_ PACKED _ CHARACTERS 2charindex, .- 


END LIST - 


PRINT SCREEN x, y, w, h, hx, hy 


A-3 


h 


b, 


transform 
control 
control 
transform 
transform 
transform 
attributes 
attributes 
mono i. 
attributes 
attributes 
attributes 
attributes 
attributes 
drawing 
control 
drawing 
drawing 
drawing 
control 
drawing 
drawing 
filled figures 
filled figures 
text 

text 

text 

text 

text 

text 

text 

text 

text 

text 

text 

text 

text 

area 

area 
control 
reports 
reports 
reports 
reports 
text 
attributes 
report 
control 
text 
control 
area 


INSTRUCTIONS IN ALPHABETIC ORDER 


A.3 INSTRUCTIONS IN ALPHABETIC ORDER 
Opcode Instruction and Arguments Function 
Length 
Opcode Word 
33 4 8452 BEGIN DEFINE CHARACTER Cc, w, nh, nw text 
31 0 7936 BEGIN FILLED FIGURE - filled figures 
46 4 11780 CREATE ALPHABET w, h, extent, type text 
23 3 5891 DRAW ARCS x, y, angle drawing 
35 N 8960+N DRAW CHARACTERS Cy, eee text 
25 N 6400+N DRAW LINES X, Yr ees drawing 
74 N 18944+N DRAW _ PACKED CHARACTERS 2charindex, ... text 
27 3 £6915 DRAW REL _ARCS dx, dy, angle drawing 
26 N 6656+N DRAW REL LINES dx, dy, ..- drawing 
36 6 0 9216 END _ DEFINE _ CHARACTER - text 
32 0 8192 END_ FILLED _ FIGURE - filled figures 
128 0 -32768 END LIST - CONErTOL 
24 0 6144 END PICTURE = COnNLTOL 
48 Q 12288 ERASE _CLIPPING REGION - area 
23: 0 -7168 FLUSH _ BUFFER - control 
1 sk 257 INITIALIZE mask control 
37 2 9474 LOAD BY NAME name 0, name_l EGXt 
34 N 8704+N LOAD CHARACTER CELL Cc, w, dQ;,. 2. Gis text 
6 O 1536 NEW_PICTURE - control 
0 O O NOP - control 
141 6 -29434 PRINT SCREEN x, y, w, h, hx, hy area 
54 0 13824 REQUEST __ CELL STANDARD - reports 
55 QO 14080 REQUEST _ CURRENT _ POSITION - reports 
57 0 14592 REQUEST OUTPUT _SIZE reports 
58 O 14848 REQUEST ‘STATUS “> reports 
71 QO 18176 REQUEST VERSION NUMBER - report 
52 2 13314 SCROLL CLIPPING REGION dx, dy area 
38 1 9729 SET ALPHABET a text 
69 2 17666 #=SET AREA CELL SIZE w, h attributes 
14 2 3586 SET AREA TEXTURE a, C attributes 
3 2 #770 SET __ AREA _ TEXTURE SIZE w, h attributes 
40 2 10242 SET_ CEEL - DISPLAY _ SIZE w, h text 
41 2 10498 SET CELL. EXPLICIT. MOVEMENT dx, dy text 
42 1 10753 SET_ CELL. | ~ MOVEMENT MODE flag text 
65 1 16641 SET CREEL. _ OBLIQUE angle text 
43 1 11009 SET_ CELL: : ~ RENDITION flags text 
44 ] 11265 SET_ CELL ROTATION angle text 
45 2 11522 oT “CELL: UNIT. SIZE w, h text 
16 6 4102 SET_ COLOR __ MAP _ ENTRY m, color, r, g, b, mono : 

9 4 2308 SET_ GIDIS | OUTPUT _ SPACE xX, Yr, W, h transform 
17 3 4355 SET_ LINE TEXTURE length, pattern, size attributes 
4 4 1028 io od Be _ OUTPUT _ CLIPPING REGION x, y, w, h_ transform 

5 6 1286 SET_ OUTPUT __ CURSOR a, Cc, w, h, Ox, oy contro 


A-4 


Rm em NOR RO SS W DN Fr 


18433 
3074 
3571 
3332 
4868 
og waz 
7426 
oe a 
7682 
3841 
3633 


INSTRUCTIONS IN ALPHABETIC ORDER 


SET OUTPUT CURSOR_RENDITION mask 
SET OUTPUT _IDS w, h 

SET OUTPUT RUBBER_BAND type, x, y 
SET OUTPUT VIEWPORT x, y, w, h 
SET PIXEL SIZE w, h, ox, oy 

SET PLANE MASK mask 

SET POSITION x, y 

SET PRIMARY COLOR color 

SET REL POSITION dx, dy 

SET SECONDARY COLOR color 

SET WRITING MODE mode 


control 
transform 
Control 

transform 
attributes 
attributes 
drawing 
attributes 
drawing 
attributes 
attributes 


REPORT TAG 


S 


CURRENT POSITION REPO 
OUTPUT SIZE REPORT 


STATUS REPORT 
CELL STANDARD REPORT 


A.e4 REPORT TAGS 
Opcode 

Length 

Opcode Word 

1 2 258 

2 9 521 

4 1 1025 

5 64 1284 

_ 2 1794 


VERSION NUMBER_REPORT 


Ri xX; 
ulx, 


4 
uly, 


screen width, 
Screen height, 
total width, 

total height, 
resolution x, 
resolution y, 


total plane mask 


code 


uw, uh, dw, dh 


code, 


version 


report 
report 


report 
report 
report 


tags 
tags 
tags 


DEC MULTINATIONAL CHARACTER SET 


DEC Multinational Character Set (C1 and GR Codes) 


°°, BITS | 


b6 


b5 
b4 b3 b2 bl 


. | 
Y | 360 | 

DCS | 144 | : oan 
90 | Yj BO | FO 

221 241 301 321 341 361 

145 161 193 209 | 225 241 

91 Al C1 D1 | E1 Fi 

222 242 A | 342 362 

146 162 a | 226 242 | 

92 A2 E2 F2 


363 
243 


343 
22) 


STS | 147 


— NY 
owm 
Ww O & 
| 
Ww 


364 
244 


RO 
(op) 
pas 
6 
2 
WD 
io) 
= 


— BRO — AO 
own on Dd 
rh DWH} a Nm 
Bae 
- W 
ome) 
NR) & AN 
fo] os “ = 
mae 
VON 
a S8lo8elo82[a88 
[o)) (oy) aos (ee) 


344 
228 


CCH | 148 


re . 
A 
| A O 
et A4 B4 C4 D4 Fa | 
| 225 245 265 305 | 325 345 365 | 
9} Yo jis} | iat | 197 | 213 229 245 
95 | AS | B5 | C5 D5 | F5 
226 | 246 | 266 306 | 326 346 366 | 
SPA | 150 166 | 7 182 | 198 | 214 230 246 
96 | AG B6 C6 D6 | F6 | 
227 247 267 | 307 | 327 | 347 367 | 
151] § | 167 133] © ji99} CE las} g¢_ {231 247 | 
97 | AT B7 c7 | 7 | E7 | F7 
230 | 250 | 270 | 310 | 330 | 350 | 370 
152} XO | 168 | 184 | 20} QO | 216 232 248 | 
98 | A8 B8 C8 D8 | ES | F8 | 
231 251 | 271 311 331 | 351 | 371 | 
1531 (©) | 169 | 185 201 | y 274 2 | 233 | 249 
99 | Ag BQ co | D9] EQ | Fo | 
232, | 252 | 272, A 312 yp | 332 | 352°] 372 
154 | 170 186 FE | 202 ye 218 | A | 234 250 | 
9A AA BA CA DAY EA FA 
233 | 253 DIB ecg |) SIS. pe. , 1398 363} =, = | 373 
CSI [155 < fiat > | 187 E |23| y {219 235 | 281 
9B AB BB cB | DB EB FB 
234 254 | 274 314] 3. | 334 354 
| ST | 156 172} Vq | 188 204 yo | 220 | 236 
gC AC BC Ce | DC EC } 
| 235 | 255 275 315} o. | 325 | 355 
| OSC | 157 173} Vo | 189} 205 f oy | 221 | 2874 
9D AD BD CD DD § ED 
: 236 256 276 ~. | sts 336 |, | 386 | 
158 174 | 190 206 | eae a 238 
9E AE BE | CE DE EE 
237 257 oi 317 | 337 357 V/ 7 
APC | 159 175 191 207) fi 223 | 239 
OF AF BF CF DF EF vf, 


= 
O 
O 
Oo 
m 
ep) 


| GR CODES | 
(DEC SUPPLEMENTAL GRAPHICS) 


APPENDIX C 


ALPHABET DATA STRUCTURE 


This Appendix describes the Alphabet Data Structure required by 
the LOAD BY NAME instruction. 


Key: 

name address ‘name’ 

<name> contents of word at address 'name' 
1. Header information (word wide) 


Header information must start at the beginning of the region. 
Word 0 in the region is alSmag. 


name description 
al $mag magic number -- must be 16473 (decimal) 
al $str structure version number -- 102 (decimal) 


al $siz size of header (bytes) -- 

al $tot total size of this entire data structure (bytes) 
(PRO/GIDIS 2.0 -- This must be <= 8KB) 

al Sflg flags -- reserved 


al Swid maximum width (bits) 
( <al_Swid> + 7 ) / 8 bytes) 
(Must be 0 to 16, inclusive. If this width is 0 to 
8, then the font information is stored in byte wide 
cells. If 9 to 16, the font information 
1s stored in word-wide cells. 


al $nom nominal width (bits). Used as the ‘alphabet width’ for 
scaling. (Must be equal to <al Swid>. 
al Shgt height (bits) 
i (0 to 16, inclusive) 
al Sfst index of first character represented in this alphabet 
al $ext extent of alphabet -- the number of characters represented i 
this alphabet. There is no specific limit, 


C=1 


ALPHABET DATA STRUCTURE 


but the entire structure must fit in 1 APR (8KB). | 
al Sptr offset from al $mag to pointer table. Pointer table MUST ~; 
PRESENT. 
al Swdt offset from al $mag to actual width table. Not used, reservec 


al S$fnt offset from al $mag to start of font data. MUST BE PRESENT. 
al Sorp offset from <al_ $Sfnt> to out _of range character font data 


(optional -- if -1 then PRO/GIDIS substitutes its own 
out _of range character) 
al S$orw actual width of out_of_range character - reserved 


Pointer table (word wide) 7 


<al_ $Spnt> offset from <al_ $fnt> to the font information for 
the character with index <al Sfst»> 
<al Spnt> + 2 offset from <al.-Sfint>.to the font. information for 


the character with index <al -Sist> + J 


<al Sptr> + 2 * ( <al $ext> - 1) 
offset from <al $fnt> to the font information for 
the last character in the alphabet 


If the ‘offset’ value is -l, then treat the character as if 
it were out of range. 


Font information (byte or word wide table, starts on 64 
byte boundary) 


This data starts at <alSfnt>. All pointers to this block are 
relative to the start of this block. 


Font information is stored for byte wide cells as: 
right portion left portion 


aaa amine a a oa > 7F © S&S 4&2 3 2 1 0 -top scan Dine 
(+1) 7 6 5 4 3 2 1 OO next to top scan ie 


(+n) 7 6 5 4 3 2 1 +0 #+bottom scan line 


+--- pointer in <al $ptr> ... 


ALPHABET DATA STRUCTURE 


Font information is stored for word wide cells as: 


right portion of character left portion 


To=> 195 14 13 Jd2 11 10° 2 8. 7 6 5 24 
(42) 15 14.123 '12 1110. 9 #@. 7 -6 “<5 4 


Ww UO 
i) 
bo! 
© 


top scan line 
2 1 0 next to top scan 


Lin 


(+2n)15 1413121110 9 8 7 6 5 4 3 2 1 +0 #+\Dbottom scan line 


hea POLMeer In: <al. -Sper> seis 


Word wide cells MUST BE ON WORD BOUNDARIES. We recommend the 
font table be set up with all word wide cells before any byte 


wide cells, especially with an odd height. PRO/GIDIS will 


Only support alphabets with total sizes less than 1 APR’s 
worth (8KB). 


Although the header is the only entity required to be in a 
fixed place, we strongly recommend that the font information 
be last and on a 64 byte boundary, so that Future 
implementations could use 1 APR to map the header information 
and 1 APR to map the font data. Our Suggested ordering: 


® header (at the start of the partition) 
@® pointer table and actual width table (in either order) 


e font table (on a 64 byte boundary) (word wide cells’ then 
byte wide cells) 


APPENDIX D 


GLOSSARY 


The words in this glossary are used throughout this manual. 
These definitions are not absolute and might differ somewhat in 
Other contexts. Where possible, the most common computer 
industry usage is the basis of the definition. 


ALPHABET 


An alphabet is a collection of characters. The component 
characters are numbered 0,1,...n-l, where n is the extent of the 
alphabet. 


ALPHABET ATTRIBUTE 


An attribute that applies to an entire alphabet. PRO/GIDIS 


Supports storage width and height as its only alphabet 
attributes. 


ANISOTROPIC 


Not isotropic. In an anisotropic coordinate space, one unit in 
the X direction is not equal to one unit in the Y direction. 


AREA TEXTURE 


A binary pattern used to shade areas. In PRO/GIDIS this is 
selected from a normal character alphabet. Area texture includes 
size parameters (specified independently) to determine the 
appearance of the pattern. 


ASPECT RATIO 


The ratio of the width of an object to its height. Objects whose 
aspect ratio are important in graphics include video displays, 
rectangular extents (picture aspect ratio), and addressing 
spaces. 


GLOSSARY 


ATTRIBUTE 


A particular property that applies to a display element (output 
primitive), such as character height, line texture, and so forth. 


BITMAP 


The rectangular array of pixels (picture elements) that is 
displayed on the Professional's video screen. AlsSo known as 
raster or frame buffer. The Professional has a bitmap 960 pixels 
wide by 240 pixels high, and either one or three planes deep. 


CHARACTER 


A character is a two-dimensional pattern made up of two "colors" 
or pixel states. A character is an element in an alphabet and is 
specified by an identifying tuple (alphabet number, character 
number). | 


CHARACTER CELL 
(See display cell or unit cell.) 
CLIPPING 


The drawing of only those parts of display elements that lie 
inside a given extent (the clipping region). 


COLOR 


A “real color" is a particular shade of light described in terms 
of its red, green, blue, and monochrome components. The color 
map can contain up to eight different real colors at one time. 


A "logical color" is a value that represents an index into the 
color map. PRO/GIDIS draws images by storing either the primary 
or secondary logical color in pixels. 


COLOR MAP 


A table with entries that contain the values of the red, green 
and blue intensities of a particular color. This table is used 
to convert logical color to real color. 


CURRENT POSITION 


The position from which lines, arcs, and characters are to _ be 
drawn. | 


GLOSSARY 


CURSOR 
A visual representation of the current position. 


DISPLAY CELL 


In text processing, the display cell is that area of the screen 
that a character should take up. The character pattern itself 
resides within a unit cell; any portion of the display cell not 
covered by the unit cell is treated as though the pattern is OFF 
for that area. If the unit cell is larger than the display cell, 
the unit cell is clipped at the display cell borders. 


DISPLAY ELEMENT 


A basic graphic element that can be used to construct a display 
image. (also known as a graphic primitive). The display 
elements for PRO/GIDIS are: lines, characters, filled figures, 
and arcs. 


FILLED FIGURE 


A GIDIS display element consisting of a polygon which is’ filled 
with a two-color pattern. 


GIDIS OUTPUT SPACE (GOS) 


An application-specified coordinate space used by all drawing and 
report operations in PRO/GIDIS. A location within the PRO/GIDIS 
output space maps to a location within the viewport on_ the 
screen. 


GLOBAL SYMMETRY 


Preservation of GIDIS Output Space relationships at the expense 
of Hardware Address Space relationships. For example, suppose 
that a ten-unit distance in GOS maps to 7.5 units in HAS. With 
global symmetry, repeatedly moving ten GOS units results ina 
move of seven HAS units, then eight has units, then seven, and so 
forth. Local symmetry always would move seven HAS units each 
time. PRO/GIDIS, version 1.7, supports global symmetry for the 
SET REL POSITION, DRAW _REL LINES, DRAW_REL_ARC and for cell 
movement after DRAW CHARACTERS ~~ or DRAW PACKED CHARACTERS 
instructions. 


HARDWARE ADDRESS SPACE (HAS) 


A coordinate space (possibly anisotropic) used by the graphic 
hardware device. GIDIS hides this space from your program, and 
addresses the hardware through an Imposed Device Space or GIDIS 
Output Space. 


GLOSSARY 


IMPOSED DEVICE SPACE (IDS) 


A coordinate space imposed on the hardware by your program. An 
Imposed Device Space requests PRO/GIDIS to simulate the requested 
device in terms of aspect ratio and addressing space. IDS is 


used only to set the viewport. All other coordinates and sizes 
are in GIDIS Output Space. 


ISOTROPIC 


In an isotropic coordinate space one unit in the X direction is 
equal to one unit in the Y direction. 


LINE TEXTURE 


A linear pattern used to help distinguish lines. Examples are 
solid, dashed, dotted, and so forth. PRO/GIDIS supports a 
two-color (binary) up to 16 units in length. 


LOCAL SYMMETRY 


Preservation of Hardware Address Space relationships at the 
expense of GIDIS Output Space relationships. For example, assume 
a ten-unit distance in GIDIS output space maps to 7.5 units in 
hardware coordinate space. Local symmetry always would move 
seven hardware units each time. With global symmetry, repeatedly 
moving ten GIDIS output space units results in a move of seven 
hardware units, then eight hardware units, then seven, and_ so 
forth. PRO/GIDIS supports local symmetry for unit cells, display 
cells, and cell movement (implicit and explicit). 


ORIGIN 


The origin of an address space is the point [0,0]. In PRO/GIDIS, 
the origin of IDS space is always the upper left corner of the 
screen. The origin of GIDIS output space is set by your program. 


The origin of a character cell (either display cell or unit cell) 
is the point in the cell placed over the current position. This 
is also the point about which the cell rotates. For P/OS, V1.7, 
the character cell origin always is the upper left corner. 


OUTPUT SPACE 


(See GIDIS output space.) 


GLOSSARY 


PICTURE ASPECT RATIO 


The ratio of the width of a picture to the height. This is 
normally expressed as two small numbers, such as 4:3. The 
picture aspect ratio on the Professional 350 monitor is 8:5. In 


this context, "picture" means a rectangular extent in an address 
space. 


PIXEL (PICTURE ELEMENT) 


The smallest element of a display surface that can be assigned a 
color or intensity. 


PIXEL ASPECT RATIO 


The ratio of the width of a pixel to the height. The width is 
the horizontal distance between adjacent pixels and the height is 
the vertical distance. Pixel aspect ratio is normally expressed 
as two small numbers, e.g. 1:2. The pixel aspect ratio on the 
Professional 350 monitor is 1:2.5 or 2:5. 


PLANE 


A plane is a portion of a bitmap that contains one bit for each 
pixel. The Professional 350 has either one plane (without EBO) 
or three planes (with EBO). 


PRIMARY COLOR 


The primary color is that logical color generally used _ to 
indicate the presence of an image. 


RUBBER BAND 


There are two types of rubber band available in PRO/GIDIS; the 
rubber band line and the rubber band rectangle. The line 
stretches from the base position to the current position. The 
rectangle has one corner at the base position and the opposite 
corner at the current position. The rectangle will degenerate to 
a line or point if the current position and base position are the 
same in one or both coordinates. 


SECONDARY COLOR 


The secondary color is that logical color generally used _ to 
indicate the absence of an image. 


STANDARD DISPLAY SIZE 


GLOSSARY 


The standard display size is normally equal to the standard unit 
size. However, for alphabet 0, rotation 0, the standard display 
size is slightly smaller (horizontally) than the standard unit 
size. This is for increased compatibility with the VT125. 


STANDARD UNIT SIZE 


The standard unit size depends on the alphabet width and height 
and the rotation angle. It 1s the size in GIDIS Output Space 
coordinates of the character displayed when one bit of the 
character pattern maps to exactly one pixel in the bitmap. 
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Address space 
in Viewing Transformation, 
Alphabet 


and REQUEST CELL STANDARD, 10-4 


creating, 1-26 
definition, D-1l 
description, 1-25 
reset state, 3-5 to 3-6 
user-defined, 1-26 
Alphabet attribute 
definition, D-l 
Anisotropic 
definition, D-1 
Arcs 
drawing, 6-7, 6-9 
Area cell size 
setting, 5-12 
Area operation 
description, 1-31 
purpose, 1-5 
Area texture 
affected by 
SET GIDIS OUTPUT SPACE, 
affected by SET OUTPUT_IDS, 
definition, D-l 
description, 1-21 
reset state, 3-4 to 3-5 
setting, 5-10 


taken from line texture, 5-10 


Area texture cell size 
description, 1-22 

Area texture size 
description, 1-22 
setting, 5-ll 

Aspect ratio 
definition, D-l 
description, 1-7 

Attribute 
definition, D-2 
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Backslant 
see cell rendition 


INDEX 


BEGIN DEFINE CHARACTER 
reference description, 8-5 
BEGIN FILLED FIGURE 


aborted by initialization, 3-3 


general description, 1-14 

reference description, 7-1 
Bitmap 

and NEW PICTURE, 3-7 

definition, D-2 

description, 1-15 
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Cartesian Coordinate System 
use of, 1-6 
Cell display size 
affected by 
SET GIDIS OUTPUT SPACE, 
affected by SET OUTPUT_IDS, 
description, 1-29 
reset state, 3-4 to 3-5 
Cell movement 
affected by 
SET GIDIS OUTPUT SPACE, 
affected by SET OUTPUT_IDS, 
description, 1-29 
reset state, 3-4 to 3-5 
Cell oblique 
description, 1-29 
reset state, 3-5 
Cell rendition 
description, 1-28 
reset state, 3-5 
Cell rotation 
description, 1-28 
reset state, 3-5 
Cell unit size 
affected by 
SET GIDIS_OUTPUT_SPACE, 
affected by SET OUTPUT IDS, 
description, 1-29 
reset state, 3-4 to 3-5 
CGL 


relationship to PRO/GIDIS, 1-2 


when to use, 1-3 
Character 
definition, D-2 


Index-l 
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INDEX 


Character cell Current position (Cont.) 
definition, D-2 affected by SET OUTPUT IDS, 4-2 
Character rotation after DRAW ARCS, 6-8 | 
and REQUEST _CELL STANDARD, 10-4 |. definition, D-2 
Clipping description, 1-13 
definition, D-2 reporting, 1-32, 10-1 
Clipping region | reset state, 3-4 
affected by setting, 6-1 to 6-2 
SET GIDIS_ OUTPUT SPACE, 4-5 Cursor 
atftected ‘by SET OUTPUT .IDS, 4-2 affected by 
and window, 1-11 SET GIDIS_OUTPUT SPACE, 4-5 
description, 1-9 affected by SET OUTPUT IDS, 4-2 
erasing, 9-1 definition, D-3 
in viewing transformation, 1-7 purpose of, 1-13 
reset state, 3-4 reset state, 3-6 
setting, 4-6 selecting built-in, 3-9 
Color setting, 3-8 
attributes, 1-15 Curve attribute 
definition, D-2 description, 1-19 
Color map 
and complement mode, 1-18 -D- 
definition, D-2 
description, 1-16 DEC Multinational Character Set 
interaction with plane mask, as alphabet 0, 1-26 | 
5-6 Display cell 
reset state, 3-6 definition, D-3 
setting, 5-3 reporting, 10-3 
values, 5-4 Display element 
Complement mode definition, D-3 
description, 1-17 DRAW_ARCS 
effect on filled figure, 1-22, and REQUEST CURRENT POSITION, 
7-3 10-2 
effect on line texture, 1-20 general description, 1-14 
effect on lines, 6-4 reference description, 6-7 
Sefiect: On pixel Size, 5-8 DRAW_CHARACTERS 
Complement negate mode and END LIST, 3-13 
description, 1-18 and REQUEST CURRENT POSITION, 
effect on filled figure, 7-3 10-2 
effect on lines, 6-4 general description, 1-15 
Control instruction invalid in filled figure, 7-2 
purpose, 1-4 parameter block, 2-7 | 
CORE Graphics Library reference description, 8-16 
see CGL DRAW _ LINES 
CREATE ALPHABET and END LIST, 3-13 
in alphabet creation, 1-26 general description, 1-14 
reference description, 8-3 parameter block, 2-7 
Current pattern reference description, 6-3 
description, 1-17 DRAW_PACKED CHARACTERS 
Current position reference description, 8-18 
affected by DRAW_REL ARCS 
SET GIDIS OUTPUT SPACE, 4-5 general description, 1-14 


Index-2 


DRAW_REL ARCS (Cont.) 
reference description, 6-9 
DRAW REL LINES 
and END LIST, 3-13 
general description, 1-14 
parameter block, 2-7 
reference description, 6-5 
Drawing instruction 
general description, 1-13 
purpose, 1-4 
$DSW variable 
values of, 2-4 to 2-5 
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EBO 
description, 1-16 
END_DEFINE CHARACTER 
reference description, 8-7 
END FILLED FIGURE 
general description, 1-14 
reference description, 7-2 
END LIST 
and DRAW _LINES, 6-3 
function of, 2-7 
general description, 1-6 
reference description, 3-13 
END PICTURE 
general description, 1-5 
reference description, 3-7 
use of, 3-6 
Erase mode 
description, 1-19 
Erase negate mode 
description, 1-19 
ERASE CLIPPING REGION 
general description, 1-31 
reference description, 9-1 
Error 
in instruction stream, 2-8 
Explicit movement 
description, 1-31 
Extended Bitmap Option 
see EBO 
Extent 
and picture aspect ratio, 1-8 
description, 1-7 


INDEX 


om fom 


Filled figure 
and DRAW LINES, 6-3 
defining, 7-1 
definition, D-3 
effect on DRAW ARCS, 6-8 
ending, 7-2 
in complement mode, 1-18 
instructions, 1-14 
purpose, 1-5 
shading to line or point, 1-22 
Filled figure attribute 
description, 1-21 
FLUSH BUFFERS 
and END PICTURE, 3-7 
general description, 1-5 
reference description, 3-8 
FORTRAN-77 
PRO/GIDIS instruction names in, 
2-6 
sample program, 2-9 
symbol name restrictions, 2-3 
use of with PRO/GIDIS, 2-1 


-G=— 
GIDIS Output Space 
see GOS 
GIGI 


and ReGIS, 1-2 
Global attribute 
affected by 
SET GIDIS OUTPUT SPACE, 4-5 
and SET OUTPUT_IDS, 4-1 
purpose, 1-4 
Global symmetry 
and SET REL POSITION, 6-2 
definition, D-3 
GOS 
affected by SET _OUTPUT_IDS, 4-2 
bounds of, 1-8 
definition, D-3 
description, 1-8 
in viewing transformation, 1-6A 
reset state, 3-4 
setting, 4-4 
unit aspect ratio, 1-8 


Index-3 


INDEX 


-H- Italic 
see cell rendition 
Hardware Address Space 


see HAS -L- 
HAS 
definition, D-3 Line 
general description, 1-11 drawing, 6-3, 6-5 
in viewing transformation, 1-7 Line attribute 
unit aspect ratio, 1-8 description, 1-19 


Line texture 
affected by 


-I- SET GIDIS OUTPUT SPACE, 4-5 
affected by SET OUTPUT IDS, 4-2 
I/O Status Block definition, D-4 - 
values of, 2-4, 2-6 description, 1=19' to 1=20 
IDS reset state, 3-4 to 3-5 
definition, D-4 setting, 5-9 
description, 1-10 LOAD BY NAME 
in viewing transformation, 1-6A reference description, 8-9 
reset state, 3-3 LOAD _CHARACTER_CELL 
setting, 4-1 and END LIST, 3-13 
unit aspect ratio, 1-8, 1-10 in alphabet creation, 1-27 
Implied movement parameter block, 2-7 
description, 1-29 reference description, 8-4 
Imposed Device Space Local symmetry 
see IDS definition, D-4 
INITIALIZE 
and RIS, 2-3 -M- 
effect on filled figure, 7-2 
general description, 1-5 MACRO-11 
reference description, 3-1 PRO/GIDIS instruction names in, 
Instruction syntax 2-6 
description, 2-6, 2-8 sample program, 2-8 
IO.RSD function code use of with PRO/GIDIS, 2-l 
format, 2-5 
in QIO, 2-1 -N- 
use of, 1-32, 2-4, 2-6 
IO.WLB function code NEW_PICTURE 
and VT1LO2 Emulator, 2-1 general description, 1-5 
IO.WSD function code reference description, 3-6 
format, 2-4 NOP 
in QIO, 2-1 general description, 1-6 
use of, 2-3 to 2-4 reference description, 3-13 


IO.WVB function code 
and VT102 Emulator, 2-1 


Isotropic -O- 
definition, D-4 

Isotropic mapping Opcode 
description, 1-8 function of, 2-6 
IDS to HAS, 1-10 Opcode word 
window to viewport, 1-9 format, 2-6 


Index-4 


INDEX 


Origin 
definition, D-4 
Output space 
definition, D-4 
Overflow 
avoiding, 1-8 
Overlay mode 
description, 1-18 
Overlay negate mode 
description, 1-18 
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Parameter block 
fixed length, 2-7 
format, 2-7 
variable length, 2-7 
PASCAL 
PRO/GIDIS instruction names in, 
2-7 
Picture aspect ratio 
definition, D-5 
description, 1-8 
Pixel 
addressing individual, 1-13 
definition, D-5 
Pixel aspect ratio 
definition, D-5 
Pixel size 
description, 1-20 
setting, 5-7 
Plane 
definition, D-5 
description, 1-15 
Plane mask 
reset state, 3-5 
setting, 5-4 
Primary color 
definition, D-5 
description, 1-16 
reset state, 3-5 
setting, 5-l 
PRINT _SCREEN 
general description, 1-31 
reference description, 9-2 


-Q- 
QOIO 


access to PRO/GIDIS, 2-1, 2-9 
expansion forms, 2-3 


QOIO (Cont.) 

FORTRAN-77 routine, 2-1 
QIOW 

see QIO 
Queue I/O Request 

see QIO 
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Read Special Data 
see IO.RSD 
ReGIS 
relationship to PRO/GIDIS, 1-2 
when to use, 1-4 
Remote Graphics Instruction Set 
see ReGIS 
Replace mode 
description, 1-18 
effect on line texture, 1-20 
effect on pixel size, 5-8 
Replace negate mode 
description, 1-19 
Report 
format, 1-32 
Report handling 
description, 1-31 
Report instruction 
purpose, 1-5 
REQUEST CELL STANDARD 
and IO.RSD, 2-4 
general description, 1-32 
reference description, 10-3 
REQUEST CURRENT POSITION 
and IO.RSD, 2-4 
general description, 1-32 
reference description, 10-1 
REQUEST OUTPUT SIZE 
general description, 1-32 
reference description, 10-4 
REQUEST STATUS 
and IO.RSD, 2-4 
general description, 1-32 
reference description, 10-2 
REQUEST VERSION NUMBER 
general description, 1-32 
reference description, 10-5 
Reset to Initial State (RIS) 
use of, 2-3 
RIS (Reset) escape sequence 
use of, 2-3 


Index-5 


Rubber band 
definition, D-5 
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Screen 
printing, 9-2 
SCROLL CLIPPING REGION 
general description, 1-31 
reference description, 9-3 
Scrolling 
by VT102 Emulator, 2-3 
SD.GDS parameter 
use of, 2-4 to 2-5 
Secondary color 
definition, D-5 
description, 1-16 
reset state, 3-5 
setting, 5-2 
Secondary color and NEW PICTURE, 
3-6 
SET ALPHABET 
general description, 1-25 
in alphabet creation, 1-26 
reference description, 8-2 
SET AREA CELL SIZE 
general description, 1-22 
reference description, 5-12 
SET AREA_TEXTURE 
effect on area cell size, 5-12 
general description, 1-21 
reference description, 5-10 
SET AREA TEXTURE SIZE 
general description, 1-22 
reference description, 5-11 
SET CELL DISPLAY SIZE 
general description, 1-29 
reference description, 8-14 
SET CELL EXPLICIT MOVEMENT 
general description, 1-29 
reference description, 8-15 
SET CELL MOVEMENT MODE 
general description, 1-29 
reference description, 8-15 
SET CELL OBLIQUE 
general description, 1-29 
reference description, 8-12 
SET CELL RENDITION 
general description, 1-28 
reference description, 8-10 


INDEX 


SET_CELL ROTATION 
general description, 1-28 
reference description, 8-11 

SET CELL UNIT SIZE 
general description, 1-29 
reference description, 8-13 

SET COLOR MAP ENTRY 
general description, 1-16 
reference description, 5-3 

SET GIDIS OUTPUT SPACE 
effect on clipping region, 1-9 
invalid in filled figure, 7-2 
purpose, 1-8 
reference description, 4-4 

SET LINE TEXTURE 
general description, 1-19 
reference description, 5-9 

SET OUTPUT CLIPPING REGION 
general description, 1-9 
reference description, 4-6 

SET _OUTPUT_CURSOR 
general description, 1-6 
reference description, 3-8 

SET _OUTPUT_CURSOR_RENDITION 
general description, 1-6, 3-10 

SET OUTPUT IDS 
general description, 1-10 
invalid in filled figure, 7-2 
reference description, 4-1 

SET _OUTPUT_RUBBER_BAND 
general description, 1-6, 3-ll 

SET OUTPUT VIEWPORT 
general description, 1-11 
invalid in filled figure, 7-2 
reference description, 4-3 

SET PIXEL SIZE 
effect on line texture, 1-20 
general description, 1-20 
reference description, 5-7 

SET PLANE MASK 
and VT1LO2 Emulator, 2-3 
general description, 1-16 
reference description, 5-4 

SET POSITION 
general description, 1-14 
invalid in filled figure, 7-2 
reference description, 6-1 

SET PRIMARY COLOR 
general description, 1-16 
reference description, 5-1] 


Index-6 


SET REL POSITION 
general description, 1-14 
invalid in filled figure, 
reference description, 
SET SECONDARY COLOR 
general description, 1-16 
reference description, 
SET WRITING MODE 


reference description, 5-7 


Standard display size 
definition, D-5 
reporting, 1-32 

Standard unit size 
definition, D-6 
reporting, 1-32 

Status 
in error condition, 
reporting, 1-32, 

SYSLIB 
as source of QIO routine, 
module QIOSYM, 2-3 


2-6 
10-2 
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Terminal emulator 
see VT102 Emulator 
see VT125 Emulator 

Text 
instruction, 

Text attribute 
description, 1-25 

Text instruction 
purpose, 1-5 

Transparent mode 
description, 1-17 

Transparent negate mode 
description, 1-17 
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Unit aspect ratio 
description, 1-7 
of GOS, 1-8 
of HAS, 1-8 
of IDS, 1-8 


6-2 
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Unit cell 
definition, 
reporting, 


D=7 
LO=3 
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Video monitor 
color, 1-12 
monochrome, 1-ll 
Viewing transformation 
definition, D-7 
description, 1-6, 
process, 1-12 
purpose, 1-4 
Viewport 
affected by SET OUTPUT_IDS, 4-2 
definition, D-7 
description, 1-1ll 
in viewing transformation, 
reset state, 3-4 
setting, 4-3 
VT102 Emulator 
interaction with PRO/GIDIS, 
to. 2-3 
of planes, 5-5 
of with PRO/GIDIS, 
Emulator 
of, 1-4 
terminal 
ReGIS, 1-2 


herd 


Loy, 
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use 
use 
VT125 
use 
VT125 
and 
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Window 
and clipping region, 
definition, D-7 
description, 1-8 
in Viewing Transformation, 1-7 
Write Special Data 
see IO.WSD 
Writing mode 
see also individual modes 
description, 1-16, 1-19 
interaction with plane mask, 
5-5 
reset state, 
setting, 5-7 
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